UTILISATION D'IRONPDF

Créer un fichier PDF avec Blazor Tutoriel

Chaknith Bin
Chaknith Bin
septembre 23, 2022
Mise à jour février 11, 2024
Partager:

IronPDF, une bibliothèque C# réputée, fonctionne avec les applications Blazor. Cet article vous guidera dans l'utilisation d'IronPDF pour intégrer un rapport PDF dans une application Blazor, en mettant en évidence son intégration transparente et son efficacité.

1. Caractéristiques d'IronPDF

Les développeurs peuvent rapidement créer, lire et traiter un document PDF à l'aide de la robuste bibliothèque IronPDF for .NET PDF. IronPDF dispose d'un moteur Chrome intégré et offre une riche gamme de capacités pratiques et puissantes. Il s'agit notamment de la possibilité de convertir des fichiers HTML5, JavaScript, CSS et des images en PDF, d'ajouter des en-têtes et des pieds de page uniques aux documents PDF et de produire des PDF exactement tels qu'ils apparaissent dans un navigateur web. IronPDF prend en charge diverses technologies web, notamment HTML, ASPX, Razor Pages et les cadres MVC.

Les principales caractéristiques d'IronPDF sont les suivantes :

2. Qu'est-ce que Blazor ?

Blazor est un cadre d'application Web qui permet de créer des applications Web côté client en C# et en 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 fichier PDF avec le tutoriel Blazor, Figure 1 : Création d'un nouveau projet dans Visual Studio

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 fichier PDF avec le tutoriel Blazor, Figure 2 : Choisir le nom et l'emplacement de la nouvelle application Blazor

Choisir le nom et l'emplacement de la nouvelle application Blazor

Sélectionnez le .NET Framework souhaité (nous utiliserons .NET 6.0 dans ce tutoriel), comme indiqué dans la capture d'écran ci-dessous :

Créer un fichier PDF avec Blazor Tutoriel, Figure 3 : Création d'un nouveau projet dans Visual Studio avec le framework .NET 6.0

Créer un nouveau projet dans Visual Studio avec le framework .NET 6.0

Microsoft Visual Studio va maintenant générer la structure de cette application Blazor.

Ensuite, ajoutez la bibliothèque IronPDF à ce nouveau 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.

Créer un fichier PDF avec Blazor Tutoriel, Figure 4 : Accéder au gestionnaire de packages NuGet de Visual Studio

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 :

Créer un fichier PDF avec le tutoriel Blazor, Figure 5 : Recherche de la bibliothèque IronPDF dans l'interface graphique du gestionnaire de packages NuGet

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

Dans l'image ci-dessus, la liste des résultats de recherche connexes est affichée. 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

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

Créer un fichier PDF avec Blazor Tutoriel, Figure 6 : Installation de la bibliothèque IronPDF avec la Console du Gestionnaire de Paquets NuGet

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 site NuGet pour 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

Visitez le site Web d'IronPDF pour télécharger directement le package 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" et 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. Créer des documents PDF dans l'application Blazor Server

L'application Blazor de ce tutoriel utilisera IronPDF pour récupérer le contenu HTML d'une page web par son URL et le convertir en document PDF.

Saisissez le code source suivant dans le fichier .razor contenu dans le projet.

@using IronPdf;

public void ExportData()
{
    try
    {
        string fileName = "Demo.pdf";
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
        JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
    }
    catch (Exception ex)
    {

    }
}
@using IronPdf;

public void ExportData()
{
    try
    {
        string fileName = "Demo.pdf";
        var renderer = new IronPdf.ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
        JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
    }
    catch (Exception ex)
    {

    }
}
Private IronPdf As [using]

Public Sub ExportData()
	Try
		Dim fileName As String = "Demo.pdf"
		Dim renderer = New IronPdf.ChromePdfRenderer()
		Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
		JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
	Catch ex As Exception

	End Try
End Sub
$vbLabelText   $csharpLabel

L'extrait de code ci-dessus utilise deux méthodes pour générer des documents PDF à partir de HTML. La première est la méthode RenderUrlAsPdf d'IronPDF, qui télécharge le contenu HTML à partir d'une URL donnée et le convertit en format PDF.

La deuxième méthode est la méthode statique JSRuntime.InvokeVoidAsync, qui déclenche le moteur JavaScript d'un navigateur pour invoquer une fonction JavaScript dans le cadre de la page web qui enregistre le contenu PDF dans un fichier sur le système de fichiers du client.

Cette fonction JavaScript est incluse ci-dessous :

<script type="text/JavaScript">
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            //Download document in Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>
<script type="text/JavaScript">
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            //Download document in Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>
HTML

La fonction JavaScript ci-dessus reçoit les données Base64 de Blazor et les convertit en un blob avant de les enregistrer à l'emplacement côté client.

Alternativement, la méthode SaveAs de la classe ChromePdfRenderer peut également être utilisée pour enregistrer des documents PDF dans le stockage local du navigateur.

5. Créer un document PDF à partir d'une chaîne HTML

L'extrait de code suivant montre comment transformer une chaîne HTML en un document.

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>")
$vbLabelText   $csharpLabel

L'exemple précédent utilise la méthode d'instance RenderHtmlAsPdf pour transformer n'importe quelle chaîne HTML en contenu PDF. En outre, la méthode SaveAs peut être utilisée dans les procédures décrites précédemment pour enregistrer ce contenu sur l'ordinateur du client.

Créer un fichier PDF avec Blazor Tutoriel, Figure 7 : L'application de génération de PDF Blazor créée dans ce tutoriel

L'application de génération de PDF Blazor créée dans ce tutoriel

La capture d'écran ci-dessus montre l'application Web développée dans ce tutoriel. En cliquant sur le bouton "Télécharger", le code C# produira le contenu PDF et une fonction JavaScript téléchargera le contenu PDF côté client.

Conclusion

Cet article a montré comment développer une application Web Blazor qui utilise la bibliothèque IronPDF PDF pour générer des fichiers PDF à partir de pages Web.

IronPDF n'est pas open source, cependant, une clé d'essai gratuite vous permet de l'utiliser en production sans filigranes.

Chaknith Bin
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il possède une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, une documentation améliorée et une expérience globale enrichie.
< PRÉCÉDENT
Tutoriel Blazor PDF Viewer
SUIVANT >
Création d'un fichier PDF dans .NET MAUI à l'aide d'IronPDF for .NET