Pour afficher des PDF provenant d'une base de données dans ASP.NET, récupérez les données binaires stockées et affichez-les à l'aide de la classe PdfDocument d'IronPDF , qui gère efficacement les tableaux d'octets et fournit une sortie compatible avec les navigateurs avec des options de personnalisation.
La gestion des documents PDF dans les applications ASP.NET implique souvent de stocker les fichiers PDF directement dans une base de données plutôt que dans le système de fichiers. Cette méthode offre une meilleure sécurité, une sauvegarde centralisée et un déploiement simplifié. Cependant, récupérer et afficher des documents PDF depuis une base de données peut être difficile sans les bons outils.
Stocker les fichiers PDF en tant que données binaires dans une table de base de données permet un meilleur contrôle sur l'accès aux documents et la gestion des versions. Lorsque vous devez afficher des documents PDF aux utilisateurs, vous devez extraire efficacement le tableau d'octets depuis la base de données et l'afficher dans le navigateur. IronPDF simplifie l'ensemble de ce processus grâce à une API efficace pour la gestion des documents PDF dans les applications ASP.NET .
Ce tutoriel présente la fonctionnalité d'affichage de PDF à partir d'une base de données en ASP.NET, en utilisant les fonctionnalités éprouvées d'IronPDF. Vous apprendrez à créer une solution complète pour le chargement, le stockage et l'affichage de fichiers PDF avec des performances et une sécurité optimales. La bibliothèque prend en charge diverses options de rendu et des fonctionnalités avancées de manipulation de fichiers PDF, ce qui simplifie la création de systèmes de gestion de documents de qualité professionnelle.
Avant de mettre en œuvre la fonctionnalité d'affichage PDF, assurez-vous que votre projet ASP.NET a IronPDF installé. Ouvrez la console du gestionnaire de packages dans Visual Studio et exécutez l'une des commandes suivantes en fonction de vos préférences d'outils :
Vous pouvez également installer IronPDF via l'interface utilisateur du Gestionnaire de packages NuGet en recherchant IronPdf dans l'onglet Parcourir de votre projet. Après l'installation, définissez votre clé de licence au démarrage de l'application :
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"Une licence d'essai gratuite vous donne un accès complet à toutes les fonctionnalités pendant la période d'évaluation. Pour les déploiements en production, consultez les niveaux de licence disponibles afin de trouver une option adaptée à l'envergure de votre projet.
La structure de votre table de base de données nécessite une colonne varbinary(max) pour stocker les fichiers PDF en tant que données binaires. La table doit inclure des champs de métadonnées comme le nom du fichier, la date de téléchargement, et la taille du fichier pour une meilleure gestion des documents. La requête SQL suivante permet de créer une table adaptée à ce scénario :
using IronPdf;
using System.Data.SqlClient;
using System.IO;
using System.Configuration;Imports IronPdf
Imports System.Data.SqlClient
Imports System.IO
Imports System.ConfigurationConfigurez votre chaîne de connexion dans le fichier web.config pour établir la connectivité avec la base de données. L'implémentation du visualiseur PDF utilisera cette connexion pour récupérer les fichiers téléchargés depuis la base de données et afficher le contenu PDF de manière fluide.
La solution utilise les espaces de noms .NET standard ainsi que l'espace de noms IronPDF . Vous n'avez besoin d'aucun ORM tiers : l'approche directe .NET minimise les dépendances et vous offre un contrôle total sur l'exécution des requêtes. Assurez-vous que la chaîne de connexion pointe vers une instance SQL Server où se trouve votre table de stockage PDF.
Commencez par créer une table de base de données spécialement conçue pour stocker des documents PDF. La structure du tableau doit pouvoir accueillir à la fois les données binaires et les métadonnées essentielles à la gestion des documents PDF :
CREATE TABLE PdfDocuments (
Id INT PRIMARY KEY IDENTITY(1,1),
FileName NVARCHAR(255) NOT NULL,
FileData VARBINARY(MAX) NOT NULL,
ContentType NVARCHAR(100) DEFAULT 'application/pdf',
FileSize INT,
UploadDate DATETIME DEFAULT GETDATE(),
CreatedBy NVARCHAR(100),
LastModified DATETIME,
DocumentVersion INT DEFAULT 1
);Cette table stocke chaque fichier PDF sous forme de tableau d'octets dans la colonne FileData. Le type de données varbinary(max) peut contenir des fichiers jusqu'à 2 Go, suffisant pour la plupart des documents PDF. Le champ FileName conserve le nom de fichier original à des fins d'affichage et de téléchargement.
Envisagez d'ajouter des index sur les colonnes fréquemment interrogées pour une meilleure performance lors de la récupération de documents PDF. La requête SQL suivante crée des index sur les colonnes les plus susceptibles d'apparaître dans les clauses WHERE et ORDER BY :
CREATE INDEX IX_PdfDocuments_UploadDate
ON PdfDocuments(UploadDate DESC);
CREATE INDEX IX_PdfDocuments_FileName
ON PdfDocuments(FileName);Cette structure garantit un stockage et une récupération efficaces des fichiers téléchargés tout en conservant la flexibilité d'ajouter des champs de métadonnées supplémentaires si nécessaire. Pour les fichiers PDF très volumineux, il convient de déterminer si le stockage en base de données est adapté à votre architecture, ou si une approche hybride – stockant les fichiers sur disque ou sur un stockage objet et ne conservant que les métadonnées dans la base de données – serait plus performante à grande échelle.
| Stratégie | Idéal pour | Avantages | Considérations |
|---|---|---|---|
| Base de données (VARBINAIRE) | Fichiers de petite à moyenne taille, haute sécurité | Cohérence transactionnelle, sauvegarde centralisée | Peut augmenter rapidement la taille de la base de données |
| Système de fichiers | Fichiers volumineux, débit élevé | E/S de fichiers rapides, faible surcharge de la base de données | Nécessite une stratégie de sauvegarde distincte |
| Stockage d'objets (Azure Blob/S3) | Déploiements dans le cloud, échelle illimitée | Rentable, très disponible | Dépendance supplémentaire du SDK |
Implémentez la fonctionnalité de téléchargement en utilisant le contrôle FileUpload d'ASP.NET. Ajoutez ce balisage HTML à votre page .aspx, dans un élément de formulaire avec une validation appropriée :
<div class="pdf-upload-container">
<asp:FileUpload ID="FileUpload1" runat="server" accept=".pdf" />
<asp:Button ID="btnUpload" Text="Upload PDF"
OnClick="btnUpload_Click" runat="server" CssClass="btn-primary" />
<asp:Label ID="lblMessage" runat="server" CssClass="status-message" />
<div class="file-info">
<asp:Label ID="lblFileInfo" runat="server" />
</div>
</div>
Le bouton de téléchargement déclenche le gestionnaire d'événements côté serveur. Voici l'implémentation complète de la fonction de téléchargement qui convertit les fichiers téléchargés en un tableau d'octets et les stocke avec une gestion des erreurs appropriée :
protected void btnUpload_Click(object sender, EventArgs e)
{
if (FileUpload1.HasFile && FileUpload1.PostedFile.ContentType == "application/pdf")
{
try
{
string fileName = FileUpload1.FileName;
byte[] fileBytes = FileUpload1.FileBytes;
int maxFileSize = 10 * 1024 * 1024; // 10MB limit
if (fileBytes.Length > maxFileSize)
{
lblMessage.Text = "File size exceeds 10MB limit.";
return;
}
// Validate PDF using IronPDF
using (var stream = new MemoryStream(fileBytes))
{
var testPdf = new IronPdf.PdfDocument(stream);
if (testPdf.PageCount == 0)
{
lblMessage.Text = "Invalid PDF file.";
return;
}
}
string constr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;
using (SqlConnection conn = new SqlConnection(constr))
{
string query = "INSERT INTO PdfDocuments (FileName, FileData, FileSize, CreatedBy) " +
"VALUES (@FileName, @FileData, @FileSize, @CreatedBy)";
using (SqlCommand cmd = new SqlCommand(query, conn))
{
cmd.Parameters.AddWithValue("@FileName", fileName);
cmd.Parameters.AddWithValue("@FileData", fileBytes);
cmd.Parameters.AddWithValue("@FileSize", fileBytes.Length);
cmd.Parameters.AddWithValue("@CreatedBy", User.Identity.Name ?? "Anonymous");
conn.Open();
cmd.ExecuteNonQuery();
}
}
lblMessage.Text = "PDF document uploaded successfully!";
lblFileInfo.Text = $"File: {fileName} ({fileBytes.Length / 1024}KB)";
LoadPdfList();
}
catch (Exception ex)
{
lblMessage.Text = "Error uploading file: " + ex.Message;
}
}
else
{
lblMessage.Text = "Please select a valid PDF file.";
}
}Imports System
Imports System.IO
Imports System.Data.SqlClient
Imports System.Configuration
Imports IronPdf
Protected Sub btnUpload_Click(sender As Object, e As EventArgs)
If FileUpload1.HasFile AndAlso FileUpload1.PostedFile.ContentType = "application/pdf" Then
Try
Dim fileName As String = FileUpload1.FileName
Dim fileBytes As Byte() = FileUpload1.FileBytes
Dim maxFileSize As Integer = 10 * 1024 * 1024 ' 10MB limit
If fileBytes.Length > maxFileSize Then
lblMessage.Text = "File size exceeds 10MB limit."
Return
End If
' Validate PDF using IronPDF
Using stream As New MemoryStream(fileBytes)
Dim testPdf As New IronPdf.PdfDocument(stream)
If testPdf.PageCount = 0 Then
lblMessage.Text = "Invalid PDF file."
Return
End If
End Using
Dim constr As String = ConfigurationManager.ConnectionStrings("DefaultConnection").ConnectionString
Using conn As New SqlConnection(constr)
Dim query As String = "INSERT INTO PdfDocuments (FileName, FileData, FileSize, CreatedBy) " &
"VALUES (@FileName, @FileData, @FileSize, @CreatedBy)"
Using cmd As New SqlCommand(query, conn)
cmd.Parameters.AddWithValue("@FileName", fileName)
cmd.Parameters.AddWithValue("@FileData", fileBytes)
cmd.Parameters.AddWithValue("@FileSize", fileBytes.Length)
cmd.Parameters.AddWithValue("@CreatedBy", If(User.Identity.Name, "Anonymous"))
conn.Open()
cmd.ExecuteNonQuery()
End Using
End Using
lblMessage.Text = "PDF document uploaded successfully!"
lblFileInfo.Text = $"File: {fileName} ({fileBytes.Length \ 1024}KB)"
LoadPdfList()
Catch ex As Exception
lblMessage.Text = "Error uploading file: " & ex.Message
End Try
Else
lblMessage.Text = "Please select a valid PDF file."
End If
End SubCe code valide le type de fichier avant le téléchargement, garantissant ainsi que seuls les fichiers PDF valides sont stockés dans la base de données. La conversion en tableau d'octets se fait automatiquement via la propriété FileBytes. La validation supplémentaire comprend la vérification de l'intégrité du PDF et des limites de taille des fichiers. L'utilisation IronPDF pour ouvrir le tableau d'octets avant l'enregistrement confirme que le fichier est un véritable document PDF analysable, et non pas simplement un fichier avec une extension renommée.
IronPDF excelle à rendre des documents PDF récupérés depuis une base de données. La bibliothèque offre plusieurs options pour afficher le contenu PDF dans les navigateurs dotés de capacités de rendu avancées. Commencez par récupérer les données binaires de votre table de base de données, puis transmettez-les à IronPDF pour traitement avant de les renvoyer au client :
private void LoadPdfList()
{
string constr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;
using (SqlConnection conn = new SqlConnection(constr))
{
string query = @"SELECT Id, FileName, FileSize, UploadDate, CreatedBy
FROM PdfDocuments
ORDER BY UploadDate DESC";
using (SqlCommand cmd = new SqlCommand(query, conn))
{
conn.Open();
SqlDataAdapter adapter = new SqlDataAdapter(cmd);
DataTable dt = new DataTable();
adapter.Fill(dt);
foreach (DataRow row in dt.Rows)
{
int fileSize = Convert.ToInt32(row["FileSize"]);
row["FileSize"] = FormatFileSize(fileSize);
}
GridView1.DataSource = dt;
GridView1.DataBind();
}
}
}
private string FormatFileSize(int bytes)
{
if (bytes < 1024) return bytes + " B";
if (bytes < 1048576) return (bytes / 1024) + " KB";
return (bytes / 1048576) + " MB";
}
private PdfData GetPdfFromDatabase(int id)
{
byte[] pdfBytes = null;
string filename = "";
string constr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;
using (SqlConnection conn = new SqlConnection(constr))
{
string query = "SELECT FileData, FileName FROM PdfDocuments WHERE Id = @Id";
using (SqlCommand cmd = new SqlCommand(query, conn))
{
cmd.Parameters.AddWithValue("@Id", id);
conn.Open();
using (SqlDataReader reader = cmd.ExecuteReader())
{
if (reader.Read())
{
pdfBytes = (byte[])reader["FileData"];
filename = reader["FileName"].ToString();
}
}
}
}
if (pdfBytes != null)
{
return new PdfData { Bytes = pdfBytes, FileName = filename };
}
return null;
}
protected void GridView1_RowCommand(object sender, GridViewCommandEventArgs e)
{
if (e.CommandName == "ViewPdf")
{
int documentId = Convert.ToInt32(e.CommandArgument);
ViewPdfDocument(documentId);
}
else if (e.CommandName == "DownloadPdf")
{
int documentId = Convert.ToInt32(e.CommandArgument);
DownloadPdfDocument(documentId);
}
}
private void ViewPdfDocument(int id)
{
var pdfData = GetPdfFromDatabase(id);
if (pdfData != null)
{
IronPdf.PdfDocument pdf;
using (var stream = new System.IO.MemoryStream(pdfData.Bytes))
{
pdf = new IronPdf.PdfDocument(stream);
}
// Apply security settings
pdf.SecuritySettings.AllowUserPrinting = true;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
Response.Clear();
Response.ContentType = "application/pdf";
Response.AddHeader("content-disposition", $"inline; filename={pdfData.FileName}");
Response.AddHeader("content-length", pdf.BinaryData.Length.ToString());
Response.BinaryWrite(pdf.BinaryData);
Response.End();
}
}Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.IO
Imports IronPdf
Private Sub LoadPdfList()
Dim constr As String = ConfigurationManager.ConnectionStrings("DefaultConnection").ConnectionString
Using conn As New SqlConnection(constr)
Dim query As String = "SELECT Id, FileName, FileSize, UploadDate, CreatedBy FROM PdfDocuments ORDER BY UploadDate DESC"
Using cmd As New SqlCommand(query, conn)
conn.Open()
Dim adapter As New SqlDataAdapter(cmd)
Dim dt As New DataTable()
adapter.Fill(dt)
For Each row As DataRow In dt.Rows
Dim fileSize As Integer = Convert.ToInt32(row("FileSize"))
row("FileSize") = FormatFileSize(fileSize)
Next
GridView1.DataSource = dt
GridView1.DataBind()
End Using
End Using
End Sub
Private Function FormatFileSize(bytes As Integer) As String
If bytes < 1024 Then Return bytes & " B"
If bytes < 1048576 Then Return (bytes \ 1024) & " KB"
Return (bytes \ 1048576) & " MB"
End Function
Private Function GetPdfFromDatabase(id As Integer) As PdfData
Dim pdfBytes As Byte() = Nothing
Dim filename As String = ""
Dim constr As String = ConfigurationManager.ConnectionStrings("DefaultConnection").ConnectionString
Using conn As New SqlConnection(constr)
Dim query As String = "SELECT FileData, FileName FROM PdfDocuments WHERE Id = @Id"
Using cmd As New SqlCommand(query, conn)
cmd.Parameters.AddWithValue("@Id", id)
conn.Open()
Using reader As SqlDataReader = cmd.ExecuteReader()
If reader.Read() Then
pdfBytes = CType(reader("FileData"), Byte())
filename = reader("FileName").ToString()
End If
End Using
End Using
End Using
If pdfBytes IsNot Nothing Then
Return New PdfData With {.Bytes = pdfBytes, .FileName = filename}
End If
Return Nothing
End Function
Protected Sub GridView1_RowCommand(sender As Object, e As GridViewCommandEventArgs)
If e.CommandName = "ViewPdf" Then
Dim documentId As Integer = Convert.ToInt32(e.CommandArgument)
ViewPdfDocument(documentId)
ElseIf e.CommandName = "DownloadPdf" Then
Dim documentId As Integer = Convert.ToInt32(e.CommandArgument)
DownloadPdfDocument(documentId)
End If
End Sub
Private Sub ViewPdfDocument(id As Integer)
Dim pdfData = GetPdfFromDatabase(id)
If pdfData IsNot Nothing Then
Dim pdf As PdfDocument
Using stream As New MemoryStream(pdfData.Bytes)
pdf = New PdfDocument(stream)
End Using
' Apply security settings
pdf.SecuritySettings.AllowUserPrinting = True
pdf.SecuritySettings.AllowUserCopyPasteContent = False
Response.Clear()
Response.ContentType = "application/pdf"
Response.AddHeader("content-disposition", $"inline; filename={pdfData.FileName}")
Response.AddHeader("content-length", pdf.BinaryData.Length.ToString())
Response.BinaryWrite(pdf.BinaryData)
Response.End()
End If
End SubLa méthode ViewPdfDocument renvoie le document au client avec les paramètres de sécurité appropriés appliqués. La disposition de contenu inline indique au navigateur d'afficher le PDF plutôt que de proposer un téléchargement. Vous pouvez ajuster les paramètres de sécurité, tels que les autorisations d'impression et les restrictions de copier-coller, afin de les adapter aux exigences de votre politique documentaire.
Les paramètres de la commande SQL sont essentiels pour récupérer en toute sécurité un PDF spécifique grâce à sa clé primaire. Les requêtes paramétrées empêchent les attaques par injection SQL et garantissent une liaison de données correcte. Après avoir récupéré les données binaires, IronPDF les charge depuis un MemoryStream, vous donnant un accès complet à l'objet document pour des manipulations ultérieures avant de l'envoyer au navigateur.
Les fonctionnalités de manipulation de fichiers PDF d'IronPDF vont bien au-delà du simple affichage. Vous pouvez manipuler le document PDF avant le rendu en y ajoutant des filigranes , des en-têtes et des pieds de page , ainsi que des signatures numériques :
// Add a confidentiality watermark before displaying
pdf.ApplyWatermark("<h2 style='color:red; font-family:Arial'>CONFIDENTIAL</h2>",
rotation: 30,
opacity: 50);
// Add page numbers in the footer
pdf.AddTextHeaders("{page} of {total-pages}",
IronPdf.Editing.TextHeaderFooter.DisplayLocation.BottomCenter);
// Add document metadata
pdf.MetaData.Author = "Your Application";
pdf.MetaData.ModifiedDate = DateTime.Now;' Add a confidentiality watermark before displaying
pdf.ApplyWatermark("<h2 style='color:red; font-family:Arial'>CONFIDENTIAL</h2>",
rotation:=30,
opacity:=50)
' Add page numbers in the footer
pdf.AddTextHeaders("{page} of {total-pages}",
IronPdf.Editing.TextHeaderFooter.DisplayLocation.BottomCenter)
' Add document metadata
pdf.MetaData.Author = "Your Application"
pdf.MetaData.ModifiedDate = DateTime.Now
Le filigrane est particulièrement utile pour afficher des documents que les utilisateurs doivent consulter mais pas reproduire mot pour mot. Vous pouvez également extraire du texte du PDF avant l'affichage pour créer des index de recherche, ou convertir des pages spécifiques en images pour générer des vignettes.
L'association d' .NET et IronPDF offre un modèle simple et adaptable, allant des petits outils internes aux systèmes de gestion de documents Enterprise . Cette approche est entièrement côté serveur ; aucune bibliothèque de rendu PDF côté client n'est requise, et le visualiseur PDF intégré au navigateur gère l'affichage une fois que le type MIME correct est renvoyé.
Les principaux atouts de ce modèle sont :
Pour une meilleure intégration web, utilisez JavaScript pour ouvrir les documents dans un nouvel onglet plutôt que de remplacer la page actuelle. Cela offre aux utilisateurs une meilleure expérience lors de la consultation d'une liste de documents :
function openPdfInNewTab(documentId) {
window.open('/PdfHandler.ashx?id=' + documentId, '_blank');
}
function openPdfInModal(documentId) {
var modal = document.getElementById('pdfModal');
var iframe = document.getElementById('pdfFrame');
iframe.src = '/PdfHandler.ashx?id=' + documentId;
modal.style.display = 'block';
}Le chemin de téléchargement suit la même logique de récupération de base de données mais utilise attachment au lieu de inline comme disposition de contenu. Cela oblige le navigateur à enregistrer le fichier plutôt qu'à l'afficher. Les deux chemins partagent le même helper GetPdfFromDatabase, maintenant le code d'accès aux données DRY.
Pour les workflows de documents basés sur des formulaires, explorez les capacités de remplissage de formulaires PDF d'IronPDF -- vous pouvez pré-remplir les champs de formulaire avant d'afficher ou de télécharger un document, ce qui est utile pour la génération de factures et la gestion de contrats.
Vérifiez toujours que l'utilisateur demandeur est autorisé à accéder à l'identifiant du document demandé avant de transmettre les données. Un simple identifiant numérique dans une chaîne de requête est facile à dénombrer ; sans contrôle d'autorisation, n'importe quel utilisateur authentifié pourrait consulter n'importe quel document en devinant les identifiants.
Les meilleures pratiques comprennent :
CreatedBy ou OwnerId et vérifiez-la par rapport à l'identité de l'utilisateur actuel avant d'interroger FileData.Pour des références externes sur les modèles de sécurité ASP.NET , le guide de sécurité OWASP ASP.NET et les directives de codage sécurisé de Microsoft pour ASP.NET constituent des conseils faisant autorité. L'entrée de la galerie NuGet pour IronPDF documente également l'historique des versions et les dépendances.
Pour mettre en œuvre cette solution dans votre propre projet :
Install-Package IronPdf or dotnet add package IronPdf).PdfDocuments en utilisant le schéma SQL ci-dessus.Vous pouvez explorer l'ensemble des fonctionnalités IronPDF pour découvrir des capacités supplémentaires telles que la conversion HTML vers PDF et la fusion et la division de PDF qui s'intègrent naturellement aux flux de travail de gestion de documents. Démarrez un essai gratuit pour tester l'intégralité de l'API avant de souscrire à une licence .
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
