Créer un fichier PDF avec le Tutoriel Blazor

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.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 sera installé 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 à partir de 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}");
        }
    }
}

[using] ReadOnly Property code() As IronPdf
	''' <summary>
	''' This method exports data by converting a URL to a PDF file and initiating its download.
	''' </summary>
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'	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(string.Format("Error in ExportData: {0}", ex.Message));
'		}
'	}
End Property

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

Alternatively, The SaveAs method from the ChromePdfRenderer class can also be used to save PDF documents to the browser's local storage.