Tutoriel Blazor PDF Viewer

Introduction

Adobe a créé le format de document portable (PDF), qui est largement utilisé pour publier du texte formaté et des images. Dans ce tutoriel, l'IronPDF est recommandé pour être intégré dans une application Blazor côté serveur pour afficher des PDF car il est facile à utiliser et efficace.

1. Caractéristiques d'IronPDF

Grâce à la puissante bibliothèque IronPDF for .NET, les développeurs peuvent facilement créer, lire et modifier un document PDF. Basé sur le moteur de rendu Chrome de IronPDF, IronPDF comprend une large gamme de fonctionnalités utiles et puissantes, telles que la capacité de convertir HTML5, JavaScript, CSS et des images en PDFs, la capacité d'ajouter des en-têtes et pieds de page personnalisés aux PDFs, et la capacité de créer des PDFs qui correspondent exactement à leur apparence dans un navigateur web.

IronPDF prend en charge plusieurs technologies web, notamment HTML, ASPX, Razor View et MVC. Les principales caractéristiques d'IronPDF sont les suivantes :

• IronPDF offre un contrôle total sur la création et la modification des fichiers PDF au sein des applications .NET C#
• IronPDF peut générer des fichiers PDF de pages web à partir de leurs URLs en utilisant des configurations spécifiques d'agent utilisateur, de proxy, d'en-tête et de cookie.
• IronPDF peut supprimer les images des documents PDF existants
• IronPDF peut ajouter du texte, des photos, des signets, des filigranes et d'autres éléments aux documents PDF
• IronPDF possède plusieurs fonctions qui peuvent fusionner et diviser des documents PDF facilement
• IronPDF est capable de comprendre et de restituer des contenus multimédias web tels que CSS et JavaScript
• IronPDF prend en charge divers frameworks d'applications Web MVC et de bureau .NET, notamment ASP.NET et Blazor

2. Qu'est-ce que Blazor ?

Blazor est un cadre expérimental d'application Web qui permet de créer des applications Web côté client en C# et HTML à l'aide de Web Assembly.

Les applications Web Assembly sont envoyées au navigateur dans un format d'instruction binaire qui peut fonctionner à une vitesse proche de la vitesse native. Cela a créé un nouveau potentiel pour des langages tels que C#, qui peuvent être exécutés dans le navigateur.

Création d'un nouveau projet dans Visual Studio

Pour commencer, ouvrez l'application Microsoft Visual Studio et sélectionnez "Nouveau projet" dans le menu Fichier. Sélectionnez ensuite "Blazor server app".

Créer un nouveau projet dans Visual Studio

Saisissez un nom de projet et sélectionnez un chemin d'accès au fichier. Ensuite, cliquez sur le bouton Créer.

Créer un nouveau projet dans Visual Studio

Sélectionnez également le Framework .NET souhaité. Il est recommandé d'utiliser la dernière version pour des raisons de stabilité.

Choisir le Framework .NET 6.0 pour la Nouvelle Application Serveur Blazor

Microsoft Visual Studio va maintenant générer la structure pour la nouvelle application Blazor Server. Ce projet inclura une collection de fichiers .razor, dans lesquels vous pouvez entrer du code source.

L'étape suivante consiste à ajouter la bibliothèque IronPDF au projet.

3. Installer la bibliothèque IronPDF

La bibliothèque IronPDF peut être téléchargée et installée de quatre façons :

• Utilisation du gestionnaire de paquets NuGet de Visual Studio
• Utilisation de la ligne de commande de Visual Studio
• Téléchargement direct depuis le site web de NuGet
• Téléchargement direct à partir du site web d'IronPDF

3.1 Utilisation du gestionnaire de paquets NuGet de Visual Studio

Visual Studio fournit le gestionnaire de paquets NuGet pour faciliter l'installation des bibliothèques directement dans les projets. La capture d'écran ci-dessous montre comment ouvrir le gestionnaire de paquets NuGet.

Accéder au gestionnaire de packages NuGet de Visual Studio

Utilisez le champ de recherche sous l'onglet Parcourir pour rechercher "IronPDF", comme le montre la capture d'écran ci-dessous :

Recherche de la bibliothèque IronPDF dans l'interface graphique du gestionnaire de packages NuGet

L'image ci-dessus montre la liste des résultats de recherche connexes. Sélectionnez les options requises pour installer le paquet dans votre projet.

3.2 Utilisation de la ligne de commande de Visual Studio

Dans Visual Studio, allez à Outils > Gestionnaire de packages NuGet > Console du gestionnaire de packages

Saisissez la ligne suivante dans l'onglet Console du gestionnaire de paquets :

Install-Package IronPdf

Install-Package IronPdf

Le paquet sera alors téléchargé et installé dans le projet en cours.

Installation de la bibliothèque IronPDF via la console du gestionnaire de packages NuGet

3.3 Téléchargement direct depuis le site web de NuGet

La troisième façon d'installer la bibliothèque IronPDF est de télécharger le paquet NuGet directement depuis le site web.

Accédez au package IronPDF sur NuGet.

• Cliquez sur l'option "Télécharger le paquet" dans le menu de droite.
• Ouvrez le paquet téléchargé sur votre système de fichiers. Il sera installé automatiquement.
• Rechargez la solution et commencez à l'utiliser dans votre projet.

3.4 Téléchargement direct depuis le site web d'IronPDF

Téléchargez le dernier package depuis le site web d'IronPDF.

Après le téléchargement, suivez les étapes suivantes pour ajouter le paquet à votre projet :

• Cliquez avec le bouton droit de la souris sur le projet dans la fenêtre de la solution.
• Sélectionnez l'option "Référence", puis naviguez jusqu'à l'emplacement de la bibliothèque que vous avez téléchargée précédemment.
• Cliquez sur OK pour ajouter la bibliothèque comme référence.

4. Visualiser des documents PDF avec l'application serveur Blazor

L'application Blazor qui sera construite dans ce tutoriel créera un document PDF à partir de l'URL d'une page web et le rendra dans le navigateur web d'un client.

Avec IronPDF, l'affichage d'un PDF est simple.

Ajoutez le code source suivant au fichier .razor correspondant.

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

Private _imgUrl As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function

Le fragment de code ci-dessus utilise d'abord la méthode RenderUrlAsPdf de IronPDF, qui télécharge le contenu HTML à partir d'une URL donnée et le convertit en format PDF. Ensuite, l'extrait de code rend le contenu du PDF généré sous la forme d'une chaîne de données base64 brutes et la stocke dans une variable locale.

Pour plus de commodité, les applications peuvent utiliser la méthode SaveAs d'IronPDF (disponible sur n'importe quelle instance de ChromePdfRenderer) pour enregistrer les documents PDF générés sur le système de fichiers du serveur afin d'y accéder rapidement plus tard.

Le segment de code suivant prépare les données PDF en base 64 pour la sortie sur le navigateur du client.

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_imgUrl != string.Empty)
Private Sub New(Optional _imgUrl (Not ByVal) As = String.Empty)
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
	"width:750px;height:750px;" type="application/pdf"/>
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type
	"@_imgUrl" style="width:750px;height:750px;" type
	<iframe src="@_imgUrl" style
End Sub

La fonction ci-dessus reçoit les données base64 du serveur Blazor côté serveur, les liant à l'attribut src d'un élément iframe. Au chargement de la page, cela déclenche l'utilisation par les navigateurs de leurs visionneuses intégrées pour rendre le contenu base64 en tant que document PDF approprié.

Ci-dessous se trouve une capture d'écran du fichier PDF lorsqu'il est rendu à partir de la chaîne base64.

Affichage d'un PDF généré dans une application Blazor dans le navigateur. Ce PDF a été créé par IronPDF et envoyé au navigateur sous forme de chaîne base64.

Afficher un document PDF à partir d'une chaîne HTML

Vous trouverez ci-dessous une illustration de la façon dont IronPDF peut créer un fichier PDF à partir d'une chaîne de balises HTML.

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var pdf = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

Le document PDF généré peut être visualisé à partir du navigateur d'un client en suivant la procédure décrite dans la section précédente.

Conclusion

Cet article a montré comment développer une application Web Blazor qui utilise la bibliothèque IronPDF pour générer un fichier PDF à partir d'une page Web et l'afficher dans le navigateur de l'utilisateur.

IronPDF n'est pas un logiciel libre ; cependant, une clé d'essai gratuite vous permet de l'utiliser en production sans filigranes.