UTILISATION D'IRONPDF

Tutoriel Blazor PDF Viewer

Mise à jour février 11, 2024
Partager:

Introduction

Adobe a créé le Portable Document Format (PDF (EN ANGLAIS))qui est largement utilisé pour la publication de textes et d'images formatés. Dans ce tutoriel, il est recommandé d'intégrer l'IronPDF dans une Application côté serveur Blazor pour afficher un PDF parce qu'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. Sur la base de la moteur Chrome intégré, IronPDF comprend un large éventail de fonctionnalités utiles et puissantes, telles que la possibilité de convertir des fichiers HTML5, JavaScript, CSS et des images en PDF, la possibilité d'ajouter des en-têtes et des pieds de page personnalisés aux PDF, et la possibilité de créer des PDF qui correspondent exactement à la façon dont ils apparaissent 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 leur URL en utilisant des configurations spécifiques de User-Agent, Proxy, Header et Cookie.
  • IronPDF peut supprimer les images des documents PDF existants
  • IronPDF peut ajouter du texte, des photos, des signets, filigraneset d'autres éléments dans les documents PDF
  • IronPDF a de multiples fonctions qui peuvent fusionner et scinder un ou plusieurs 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".

Blazor PDF Viewer Tutorial, Figure 1 : Création d'un nouveau projet dans Visual Studio

Création d'un nouveau projet dans Visual Studio

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

Tutoriel Blazor PDF Viewer, Figure 2 : Création d'un nouveau projet dans Visual Studio

Création d'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é.

Tutoriel Blazor PDF Viewer, Figure 3 : Choix du Framework .NET 6.0 pour la nouvelle application Blazor Server

Choisir le Framework .NET 6.0 pour la nouvelle application Blazor Server

Microsoft Visual Studio va maintenant générer la structure de la nouvelle application Blazor Server. Ce projet comprendra une collection de fichiers .razor, dans lesquels vous pourrez entrer le 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.

Blazor PDF Viewer Tutorial, Figure 4 : Accès au gestionnaire de paquets NuGet de Visual Studio

Accéder au gestionnaire de paquets 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 :

Tutoriel Blazor PDF Viewer, Figure 5 : Recherche de la bibliothèque IronPDF dans l'interface graphique du gestionnaire de paquets NuGet

Recherche de la bibliothèque IronPDF dans l'interface graphique du gestionnaire de paquets 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 dans Tools > NuGet Package Manager > Package Manager Console

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

Install-Package IronPdf

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

Tutoriel Blazor PDF Viewer, Figure 6 : Installation de la bibliothèque IronPDF à l'aide de la console NuGet Package Manager

Installation de la bibliothèque IronPDF à l'aide de la console NuGet Package Manager

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.

Naviguez jusqu'à https://www.nuget.org/packages/IronPdf/

  • 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

Cliquez sur ce lien pour télécharger le dernier paquet directement à partir du 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
VB   C#

L'extrait de code ci-dessus utilise d'abord la fonction RenderUrlAsPdf (RenderUrlAsPdf) qui télécharge le contenu HTML d'une URL donnée et le convertit au 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 fonction d'IronPDF SaveAs méthode (disponible sur n'importe quel ChromePdfRenderer instance) pour enregistrer les documents PDF générés sur le système de fichiers du serveur afin d'y accéder rapidement par la suite.

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
VB   C#

La fonction ci-dessus reçoit les données base64 du côté serveur de Blazor, en les liant à l'attribut src d'un élément iframe. Lors du chargement de la page, les navigateurs utilisent leurs visionneurs Web intégrés pour rendre le contenu base64 sous la forme d'un document PDF approprié.

Voici une capture d'écran du fichier PDF rendu à partir de la chaîne base64.

Tutoriel Blazor PDF Viewer, Figure 7 : Visualisation dans le navigateur d'un PDF généré dans une application Blazor. Ce PDF a été créé par IronPDF et envoyé au navigateur sous la forme d'une chaîne base64.

Visualisation dans le navigateur d'un PDF généré dans une application Blazor. Ce PDF a été créé par IronPDF et envoyé au navigateur sous la forme d'une 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>")
VB   C#

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 clé d'essai gratuite vous permet de l'utiliser en production sans filigrane.

< PRÉCÉDENT
Création d'un générateur de PDF en ASP.NET Core à l'aide d'IronPDF
SUIVANT >
Créer un fichier PDF avec Blazor Tutoriel