UTILISATION D'IRONPDF

C# ; Créer un fichier PDF par programmation

Mise à jour novembre 14, 2023
Partager:

Pour les développeurs, il existe de nombreux scénarios dans lesquels il est nécessaire de créer des fichiers PDF de manière programmatique. Il se peut que vous deviez générer des rapports PDF et d'autres fichiers PDF par programmation dans votre logiciel. Il serait long, coûteux et inefficace d'écrire votre code et vos fonctions à partir de zéro. C'est là qu'intervient IronPDF. Bien que la création de fichiers PDF par programmation dans .NET puisse être frustrante, il existe heureusement une solution qui la rend beaucoup plus facile à gérer.

Thèmes abordés dans le didacticiel

Nous aborderons les sujets suivants dans ce tutoriel :

  • Étapes pour créer des fichiers PDF par programme
  • Étape 1 : Créer un projet C#
  • Étape 2 : Installer la bibliothèque IronPdf
    • Méthode 1 : NuGet Package Manager
    • Méthode 2 : Console du gestionnaire de paquets NuGet
    • Méthode 3 : Utilisation d'un fichier DLL
  • Étape 3 : Ajouter l'espace de nommage IronPDF
  • Étape 4 : Créer un document PDF par programme
    • 4.1 : Créer un document PDF par programmation à l'aide d'une chaîne HTML
    • 4.2 : Créer un document PDF par programmation à l'aide de fichiers HTML
    • 4.3 : Créer un document PDF par programmation à l'aide d'une URL
    • 4.4 : Créer un document PDF par programme avec mise en forme
  • Résumé

IronPDF

L'IronPDF est un Bibliothèque PDF C# qui fournit un ensemble de classes pouvant être utilisées pour créer des fichiers PDF de manière programmatique. Ces classes se trouvent dans l'assemblage `IronPDF`` et sont conçues pour être faciles à utiliser avec n'importe quel langage .NET, y compris C#, VB.NET, F#, etc. La bibliothèque offre de nombreuses fonctions pour créer des documents PDF, manipuler des PDF existants et lire des PDF.

La version actuelle de la bibliothèque IronPDF prend en charge les fonctionnalités suivantes :

Étapes à suivre pour créer des fichiers PDF par programmation

Cet article utilisera le modèle d'application console pour cette démonstration. Vous pouvez utiliser n'importe lequel d'entre eux en fonction de vos besoins et de votre choix. Vous pouvez également utiliser votre projet existant dans lequel vous souhaitez ajouter un outil de génération de fichiers PDF.

Étape 1 : Créer un projet C

Ce tutoriel utilisera Visual Studio et le langage de programmation C# pour construire notre projet. Vous devez avoir des connaissances de base en HTML et en langage C#. Il est également recommandé de se familiariser avec Visual Studio.

Nous allons examiner les différentes méthodes permettant de créer des fichiers PDF par programmation à l'aide de la bibliothèque IronPDF C#. Commençons par créer un projet C#.

  • Ouvrez Visual Studio.
  • Créez un nouveau projet C# ou ouvrez un projet existant.
  • Donner un nom au projet.
  • Sélectionnez .NET Core >= 3.1 car la version 3.1 est prise en charge et fonctionne sur tous les appareils. Recommandez la dernière version de .NET Core.

    Passons maintenant à l'étape 2.

Étape 2 : Installer la bibliothèque IronPDF

Avant de continuer, nous devons installer la bibliothèque IronPDF dans notre projet. Nous pouvons le faire de différentes manières.

Méthode 1 : NuGet Package Manager

Nous pouvons installer la bibliothèque C# IronPdf à partir du gestionnaire de paquets NuGet. Ouvrez le NuGet Package Manager en cliquant sur Tools > NuGet Package Manager > Manage NuGet Package Solution. L'explorateur de solutions du gestionnaire de paquets NuGet s'ouvre alors.

C&num ; Créer un fichier PDF par programmation, Figure 1 : Ouvrir le gestionnaire de paquets NuGet Open NuGet Package Manager

Cliquez sur Parcourir et écrivez IronPDF dans la barre de recherche. Le résultat suivant s'affiche. Sélectionnez IronPDF et cliquez sur le bouton Installer ; la bibliothèque commencera à s'installer.

C&num ; Créer un fichier PDF par programmation, Figure 2 : Rechercher et installer le package IronPDF Recherche et installation du paquet IronPDF

Méthode 2 : Console du gestionnaire de paquets NuGet

Nous pouvons utiliser la console NuGet Package Manager pour installer facilement notre bibliothèque. Son installation ne nécessite aucun privilège administratif. Vous allez utiliser une commande NuGet pour installer la bibliothèque IronPDF dans votre projet.

Install-Package IronPdf

C&num ; Créer un fichier PDF par programmation, Figure 3 : Installer le paquetage IronPDF via la ligne de commande Installer le paquetage IronPDF via la ligne de commande

Méthode 3 : Utilisation d'un fichier DLL

La troisième façon d'utiliser IronPDF dans votre projet est d'ajouter un fichier DLL de la bibliothèque IronPDF. Vous pouvez télécharger le fichier DLL.

  • Téléchargez le fichier zip de la DLL. Extrayez-le dans un dossier spécifique.
  • Ouvrez un projet dans Visual Studio. Dans l'explorateur de solutions, cliquez avec le bouton droit de la souris sur References et recherchez le fichier DLL IronPDF.

    Visitez un site plus guide d'installation détaillé.

Étape 3 : Ajouter l'espace de nommage IronPDF

Ajoutez maintenant l'espace de noms IronPDF à votre programme. Vous devez ajouter une ligne de code donnée au-dessus du code.

utiliser IronPDF

Cela vous permettra d'accéder aux fonctions d'IronPDF. Vous devez ajouter cette ligne de code à chaque fichier dans lequel vous souhaitez utiliser les fonctionnalités d'IronPDF.

Étape 4 : Créer des documents PDF par programmation

Nous allons examiner plusieurs méthodes pour créer des PDF, comme le propose IronPDF. Nous verrons à quel point il est facile d'utiliser des fonctions simples pour créer des fichiers PDF. Commençons par créer des PDF à l'aide de la chaîne HTML.

4.1. Créer des PDF par programmation à l'aide d'une chaîne HTML

Dans la bibliothèque IronPDF, le HTML est utilisé à des fins de stylisme. Vous devez avoir des connaissances de base du langage HTML pour générer des documents PDF à l'aide de la bibliothèque IronPDF.

La bibliothèque IronPDF permet de traiter très facilement les chaînes HTML et de les convertir au format PDF. Voyons comment le faire en utilisant du code.

string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";
var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>";
var renderer = new ChromePdfRenderer();
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");
Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is great Library to manipulate PDF Files.</p>"
Dim renderer = New ChromePdfRenderer()
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")
VB   C#

Ce code génère un fichier PDF contenant le contenu de la variable htmlString. Dans cet exemple de code, le RenderHtmlAsPdf (RenduHtmlAsPdf) a été utilisée. Cette fonction permet de convertir une chaîne HTML en un document PDF.

Vous devez être familiarisé avec les balises HTML pour générer des fichiers PDF à l'aide de la bibliothèque IronPDF. Nous utilisons la fonction SaveAs pour enregistrer le fichier PDF de sortie. Vous pouvez voir le fichier PDF de sortie ci-dessous.

Output:

C&num ; Créer un fichier PDF par programmation, Figure 4 : Sortie d'un fichier PDF Fichier de sortie PDF

4.2. Créer des PDF par programmation à l'aide de fichiers HTML

La bibliothèque IronPDF offre une fonction fantastique pour créer un fichier PDF à partir d'un fichier HTML. IronPDF convertit directement tout ce qui se trouve dans un fichier HTML, y compris les images, les feuilles de style CSS, les formulaires, etc. en un document PDF. Il ne nécessite aucune autre bibliothèque ou fonction pour la suite du traitement. IronPDF convertit directement n'importe quel fichier HTML en fichier PDF.

Examinons un exemple de code permettant de créer un fichier PDF à partir d'un fichier HTML :

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Nous utilisons le RenderHtmlFileAsPdf (Rendre le fichier HTML sous forme de fichier PDF) pour créer des PDF à partir de fichiers HTML. Cette fonction est la plus importante fonction utilisée dans l'exemple de code donné. Vous pouvez indiquer l'emplacement du fichier HTML dans le paramètre de la fonction ou placer le fichier HTML dans le dossier bin du code source, vous n'aurez donc qu'à indiquer le nom du fichier avec son extension dans le paramètre de la fonction RenderHtmlFileAsPdf. Le fichier PDF de sortie sera enregistré dans le dossier bin lorsque vous exécuterez ce code. La fonction SaveAs vous permet d'enregistrer les fichiers PDF créés.

4.3. Créer des PDF par programmation à l'aide d'URL

Il arrive que nous devions créer des fichiers PDF d'une URL de manière programmatique dans notre programme. Cela peut être une tâche très technique si nous codons tout à partir de zéro. IronPDF nous aide ici en fournissant une excellente fonction de création de PDF à partir d'URL. Vous pouvez utiliser n'importe quelle URL pour créer un PDF.

Voyons comment procéder :

var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
var Renderer = new ChromePdfRenderer();
var PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");
Dim Renderer = New ChromePdfRenderer()
Dim PDF = Renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")
VB   C#

Le code ci-dessus créera un PDF à partir du paramètre URL donné vers le fichier RenderUrlAsPdf (RenderUrlAsPdf) fonction. Cette fonction crée un PDF de l'URL. Cette tâche serait autrement très complexe si vous essayiez de la réaliser à partir de zéro, c'est pourquoi IronPDF offre aux développeurs un processus simple pour convertir n'importe quelle URL en PDF. La fonction SaveAs est utilisée pour enregistrer les fichiers de sortie dans le dossier bin. Pour définir le format de fichier au format PDF, vous devez spécifier une extension .pdf avec un paramètre de nom de fichier dans la fonction SaveAs. Vous pouvez voir le dossier bin dans votre dossier de projet. Le résultat est affiché ci-dessous.

Output:

C&num ; Créer un fichier PDF par programmation, Figure 5 : Créer un fichier PDF à partir d'une URL Créer un fichier PDF à partir d'une URL

4.4. Créer des PDF par programmation à l'aide de ASP.NET Web Forms

ASP.NET est un framework de programmation côté serveur qui étend les fonctionnalités de HTML et prend en charge le développement web dans un navigateur. Les pages ASP.NET sont écrites en HTML, CSS et JavaScript, et peuvent être codées sous forme de fichiers ASPX (.aspx). Les formulaires web ASP.NET permettent de créer des sites web conviviaux et riches en fonctionnalités, des banques en ligne, des intranets et des systèmes de comptabilité.

Nous utiliserons la bibliothèque IronPDF pour convertir les formulaires web ASP.NET en PDF. Initialement rendu sous forme de page web, nous le transformerons en PDF pour qu'il puisse être visualisé et téléchargé dans un navigateur web. Nous utiliserons la classe AspxToPdf d'IronPDF pour effectuer la conversion.

Voyons comment procéder :

  1. Créez un projet de formulaire web ASP.NET dans Visual Studio. La dernière version de Visual Studio est recommandée.
  2. Installez la bibliothèque IronPDF en utilisant le NuGet Package Manager du fichier DLL selon votre choix. Vous pouvez également utiliser la console NuGet Package Manager pour l'installer.
  3. Maintenant, ouvrez n'importe quel code de page web apex que vous souhaitez convertir en fichier PDF. Ici, nous allons créer un PDF de la page aspx par défaut du projet.

    C# ; Créer un fichier PDF par programmation, Figure 6 : Structure d'un projet Web Form dans Visual Studio Structure d'un projet de formulaire web dans Visual Studio

  4. Ouvrez le fichier Default.aspx.cs. Ajoutez l'espace de noms IronPDF au fichier, ce qui est la ligne la plus importante.

    utilisant IronPDF;

  5. Écrivez la ligne de code suivante dans la fonction Page_Load pour créer un document PDF de la page.

    AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

    Et c'est tout! Un fichier PDF de la page web Aspx a été créé. Lorsque vous exécutez le projet, vous verrez un PDF de la page web dans le navigateur. Le résultat est le même que lorsque vous créez un PDF en appuyant sur Ctrl+P. Ici, il n'était pas nécessaire d'appuyer sur Ctrl+P pour créer un PDF du fichier aspx.

    Cela a été fait côté serveur. Dans ce code, nous utilisons la classe AspxToPdf d'IronPDF. La fonction RenderThisPageAsPdf crée le PDF de la page web Aspx.

    Le code ci-dessus affiche le fichier PDF dans le navigateur. Nous pouvons télécharger le fichier PDF directement dans notre système en ajoutant la ligne de code suivante dans la fonction Page_Load :

    AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

    Ce code télécharge le fichier PDF de la page web aspx dans le système. Nous pouvons également définir le nom du fichier PDF Aspx. De nombreuses options sont disponibles pour les modifications et le formatage, telles que les en-têtes, les pieds de page, les options d'impression, la qualité, etc. Pour plus de détails, visitez ce site lien.

    Output:

    C&num ; Créer un fichier PDF par programmation, Figure 7 : Résultat du rendu d'un fichier PDF à partir du serveur Sortie du rendu d'un fichier PDF du côté du serveur

    Explorer les dernières technologies Microsoft Application Blazor pour la création de fichiers PDF

4.4. Créer des PDF par programmation avec formatage

Lors de la création de PDF, la plupart des problèmes sont rencontrés lors de la mise en forme des documents PDF. Il n'est pas facile de formater les PDF de manière programmatique. Mais nous avons maintenant une solution sous la forme d'IronPDF. IronPDF propose diverses options de formatage pour nous permettre de personnaliser le fichier PDF que nous sommes en train de créer. Il nous fournit des méthodes pour ajouter des en-têtes, des pieds de page, des marges et de nombreuses autres options de formatage.

L'utilisation d'IronPDF nous permet de définir l'orientation et la taille des pages, ainsi que les titres. Il permet également de modifier la taille, la couleur et le type des polices, ainsi que d'autres opérations liées aux polices. Vous pouvez ajouter des pieds de page et des en-têtes avec une ligne de séparation et un texte personnalisé. Voyons comment personnaliser les fichiers PDF à l'aide d'IronPDF.

  • Créez un projet de console C#. Vous pouvez également créer un projet GUI, en fonction de vos besoins. Vous pouvez également ouvrir des projets existants.
  • Installez la bibliothèque IronPDF à l'aide du NuGet Package Manager ou du fichier DLL.
  • Ajoutez l'espace de noms IronPDF en haut du fichier de code.

    L'installation de l'application est maintenant terminée. Ensuite, ajoutez le code suivant au fichier PDF :

ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();
Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;
//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  
Renderer.RenderingOptions.FirstPageNumber = 1; 
//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.FontFamily = "Helvetica,Arial";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;
//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
ChromePdfRenderer Renderer = new IronPdf.ChromePdfRenderer();
Renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
Renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
Renderer.RenderingOptions.PrintHtmlBackgrounds = true;
Renderer.RenderingOptions.Title = "PDF Generated";
Renderer.RenderingOptions.Zoom = 100;
//Margin Setting
Renderer.RenderingOptions.MarginTop = 40;  
Renderer.RenderingOptions.MarginLeft = 20;  
Renderer.RenderingOptions.MarginRight = 20;  
Renderer.RenderingOptions.MarginBottom = 40;  
Renderer.RenderingOptions.FirstPageNumber = 1; 
//Header Setting
Renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
Renderer.RenderingOptions.TextHeader.CenterText = "Header!";
Renderer.RenderingOptions.TextHeader.FontFamily = "Helvetica,Arial";
Renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;
//Footer Setting
Renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
Renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
Renderer.RenderingOptions.TextFooter.FontSize = 10;
Renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
Renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF the best ever library for PDF operations and formatting. </p>";
Renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Ce morceau de code formate les fichiers PDF. Options de rendu est le principal outil permettant de définir différentes propriétés lors de la création de documents PDF.

  • Renderer.RenderingOptions.TextHeader
    • Cette ligne de code est utilisée pour définir l'en-tête du fichier PDF. Cette ligne de code vous permet d'accéder à d'autres propriétés de l'en-tête.
  • Renderer.RenderingOptions.TextFooter
    • Cette ligne de code définit les propriétés du pied de page, telles que le texte, les côtés droit et gauche du pied de page, la taille de la police, et bien d'autres encore.
  • Renderer.RenderingOptions.PaperOrientation
    • Cette ligne de code permet à l'utilisateur de définir l'orientation de la page du fichier PDF. Il peut être désigné comme paysage ou portrait.
  • Renderer.RenderingOptions.Title

    • Nous pouvons utiliser cette ligne pour définir le titre du fichier PDF.

    Pour les dernières lignes, nous utilisons la fonction RenderHtmlAsPdf pour créer un PDF à partir d'une chaîne HTML, mais nous pouvons utiliser une fonction RenderHtmlAsPdf Fichier HTML pour le convertir en PDF tout en préservant le formatage actuel. Il s'agit d'une fonction très pratique d'IronPDF qui vous donne la liberté totale de personnaliser tout ce qui concerne les documents PDF.

    Output:

    C# ; Créer un fichier PDF par programmation, Figure 8 : Sortie PDF avec prise en charge du formatage Sortie PDF avec prise en charge du formatage

Résumé

Ce tutoriel montre comment créer des fichiers PDF par programmation à l'aide de la bibliothèque IronPDF C#. Nous avons vu comment créer des fichiers PDF à partir de chaînes HTML, de fichiers HTML, d'URL et de formulaires web ASP.NET. La manipulation et le formatage des fichiers PDF deviennent très faciles grâce à la fonction de bibliothèque d'IronPDF. Il suffit de quelques lignes de code pour créer et formater le fichier PDF par programme. IronPDF est idéal pour les développeurs et les entreprises qui ont besoin de manipuler des fichiers PDF dans leur logiciel.

Vous pouvez essayer la version gratuite pour le tester, et il y a une clé d'essai gratuite qui ne nécessite aucun paiement par carte de crédit. Plus loin, l'offre spéciale actuelle vous permet d'obtenir cinq produits d'IronPDF pour le prix de deux seulement.

< PRÉCÉDENT
Comment construire un générateur de PDF en C#
SUIVANT >
Comment ouvrir un fichier PDF dans C# ;