IronPDF, une bibliothèque renommée en C#, fonctionne avec les applications Blazor. Cette revue vous guidera à travers l'utilisation d'IronPDF pour intégrer un rapport PDF dans une application Blazor, montrant son intégration transparente et son efficacité.

1. Fonctionnalités d'IronPDF

Les développeurs peuvent rapidement créer, lire et traiter un document PDF avec l'aide de la bibliothèque PDF robuste IronPDF for .NET. IronPDF possède un moteur Chrome intégré et offre une multitude de fonctionnalités pratiques et puissantes. Cela inclut la possibilité de convertir HTML5, JavaScript, CSS et images en PDF, la capacité d'ajouter des en-têtes et pieds de page uniques aux documents PDF, et la capacité de produire des PDF exactement comme ils apparaissent dans un navigateur Web. IronPDF prend en charge diverses technologies Web, y compris HTML, ASPX, Razor Pages et frameworks MVC.

Les principaux attributs d'IronPDF sont les suivants :

• IronPDF offre un contrôle total sur la création et la modification de fichiers PDF au sein des applications .NET C#
• IronPDF peut générer des fichiers PDF de pages Web à partir de leurs URL en utilisant des configurations spécifiques de User-Agent, Proxy, en-tête et Cookie.
• IronPDF peut générer des fichiers PDF pour les pages Web situées derrière des formulaires de connexion en utilisant des variables de formulaire
• IronPDF peut extraire et/ou supprimer des photos des fichiers PDF préexistants
• IronPDF peut ajouter du texte, des photos, des signets, des filigranes, et d'autres éléments aux documents PDF
• IronPDF facilite la fusion et la division des pages d'un ou plusieurs documents PDF.
• IronPDF peut traiter les ressources de page Web telles que JavaScript, CSS et fichiers multimédias et les rendre dans des documents PDF comme ils apparaissent dans un navigateur.
• IronPDF prend en charge tous les frameworks .NET, y compris .NET Core, .NET Standard, etc.

2. Qu'est-ce que Blazor?

Blazor est un framework d'application Web qui permet de créer des applications Web côté client en C# et HTML en utilisant Web Assembly.

Les applications Web Assembly sont envoyées au navigateur dans un format d'instruction binaire qui peut fonctionner à une vitesse proche de celle d'origine. Cela a créé de nouvelles opportunités pour des langages comme C# de fonctionner dans le navigateur.

Création d'un nouveau projet dans Visual Studio

Pour commencer, ouvrez l'application Microsoft Visual Studio et sélectionnez "New Project" dans le menu Fichier. Ensuite, sélectionnez "Blazor Server App".

Création d'un nouveau projet dans Visual Studio

Entrez un nom de projet et sélectionnez un chemin de fichier. Ensuite, cliquez sur le bouton Créer.

Choisir le nom et la localisation de la nouvelle application Blazor

Sélectionnez le framework .NET souhaité (nous utiliserons .NET 6.0 dans ce tutoriel), comme montré dans 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 pour 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 manières :

• En utilisant le gestionnaire de packages NuGet de Visual Studio
• En utilisant la ligne de commande de Visual Studio
• En téléchargeant directement depuis le site NuGet
• En téléchargeant directement depuis le site IronPDF

3.1 Utilisation du gestionnaire de packages NuGet de Visual Studio

Visual Studio fournit le gestionnaire de packages NuGet pour aider à installer des bibliothèques directement dans les projets. La capture d'écran ci-dessous montre comment ouvrir le Gestionnaire de packages NuGet.

Accéder au gestionnaire de packages NuGet de Visual Studio

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

Recherche de la bibliothèque IronPDF dans l'interface utilisateur 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 package 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

Entrez la ligne suivante dans l'onglet Package Manager Console :

Install-Package IronPdf

Le package sera maintenant téléchargé et installé dans le projet actuel.

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

3.3 Téléchargement direct depuis le site NuGet

Le troisième moyen d'installer la bibliothèque IronPDF est de télécharger le package NuGet directement depuis le site web.

Accédez au site NuGet pour IronPDF.

• Cliquez sur l'option "Download Package" dans le menu sur le côté droit.
• Ouvrez le package téléchargé sur votre système de fichiers. Il s'installera automatiquement.
• Rechargez la solution et commencez à l'utiliser dans votre projet.

3.4 Téléchargement direct depuis le site IronPDF

Visitez le site IronPDF pour télécharger le package IronPDF directement.

Après avoir téléchargé, suivez ces étapes pour ajouter le package à votre projet :

• Faites un clic droit sur le projet depuis la fenêtre de solution.
• Sélectionnez l'option "Add" > "Reference" 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 en tant que référence.

4. Créer des documents PDF dans l'application Blazor Server

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

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

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

L'extrait de code ci-dessus utilise deux méthodes pour générer des documents PDF à partir du HTML. Le premier est la méthode RenderUrlAsPdf d'IronPDF, qui télécharge le contenu HTML 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 sur un fichier du système de fichiers du client.

Cette fonction JavaScript est incluse ci-dessous :

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft 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">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft 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 sur la localisation 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.

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

L'exemple précédent utilise la méthode d'instance RenderHtmlAsPdf pour transformer n'importe quelle chaîne de HTML en contenu PDF. De plus, 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.

Application de génération PDF de Blazor créée dans ce tutoriel

La capture d'écran ci-dessus montre l'application Web développée dans ce tutoriel. Cliquer sur le bouton de téléchargement déclenchera le code C# pour produire le contenu PDF, et une fonction JavaScript pour télécharger le contenu PDF sur le côté client.

Conclusion

Cet article a démontré comment développer une application Web Blazor qui utilise la bibliothèque PDF IronPDF 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.