Créer un fichier PDF avec Blazor Tutoriel

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 aun 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 :

• IronPDF offre un contrôle total sur la création et la modification des fichiers PDF au sein des applications .NET C#
• IronPDF peutgé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 générer des fichiers PDF pour des pages web situées derrièreformulaires de connexion utilisant des variables de formulaire
• IronPDF peutextraire et/ou supprimer des photos à partir de fichiers PDF préexistants
• IronPDF peut ajouter du texte, des photos, des signets,filigraneset d'autres éléments dans les documents PDF
• IronPDF facilite la création defusionner et scinder des pages d'un ou plusieurs documents PDF.
• IronPDF peut traiter les éléments d'une page web tels que JavaScript, CSS et les fichiers multimédias et les convertir en documents PDF tels qu'ils apparaîtraient dans un navigateur.
• IronPDF prend en charge tous les Framework .NET, notamment .NET Core, .NET Standard, etc.

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

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

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 :

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.

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'àSite web 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 pourtélécharger le package IronPDF 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)
    {

    }
}

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

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'IronPDFRenderUrlAsPdf (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>

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, leSaveAs de la méthodeChromePdfRenderer 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>")

L'exemple précédent utilise l'optionRenderHtmlAsPdf (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.

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