UTILISATION D'IRONPDF

Créer un fichier PDF avec Blazor Tutoriel

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 a un moteur Chrome intégré et offre une multitude de possibilité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 Blazor Tutoriel, 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.

Créer un fichier PDF avec Blazor Tutorial, 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 Framework .NET souhaité (nous utiliserons .NET 6.0 dans ce tutoriel)comme le montre la capture d'écran ci-dessous :

Créer un fichier PDF avec Blazor Tutoriel, Figure 3 : Créer un nouveau projet dans Visual Studio avec le Framework .NET 6.0 Création d'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 Tutorial, Figure 4 : Accéder 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 :

Create a PDF File with Blazor Tutorial, 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

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 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.

Créer un fichier PDF avec le tutoriel Blazor, 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 sur le site web d'IronPDF pour télécharger le dernier paquet directement.

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)
    {
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

L'extrait de code ci-dessus utilise deux méthodes pour générer des documents PDF à partir de HTML. Le premier est celui d'IronPDF RenderUrlAsPdf (RenderUrlAsPdf) qui télécharge le contenu HTML d'une URL donnée et le convertit au format PDF.

La seconde méthode est la méthode statique JSRuntime.InvokeVoidAsync, qui déclenche le moteur JavaScript du navigateur pour invoquer une fonction JavaScript dans la portée 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, le SaveAs de la méthode ChromePdfRenderer peut également être utilisée pour enregistrer des documents PDF dans la mémoire locale 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>")
VB   C#

L'exemple précédent utilise l'option RenderHtmlAsPdf (RenduHtmlAsPdf) pour transformer n'importe quelle chaîne de caractères HTML en contenu PDF. De plus, la méthode SaveAs peut être utilisée dans les procédures décrites précédemment pour sauvegarder ce contenu sur l'ordinateur du client.

Créer un fichier PDF avec Blazor Tutorial, 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 un logiciel libre clé d'essai gratuite vous permet de l'utiliser en production sans filigrane.

< PRÉCÉDENT
Tutoriel Blazor PDF Viewer
SUIVANT >
Création d'un fichier PDF dans .NET MAUI à l'aide d'IronPDF for .NET