Comment générer un PDF en C# (.NET 5) en utilisant PDFSharp

Installation et Configuration

Avant d'entrer dans le code, l'orateur souligne que la configuration de l'environnement pour PDFsharp peut être assez difficile. Ils expliquent que trois packages NuGet doivent être installés avant de travailler avec Détails du package NuGet PDFsharp. Le premier package est PDFsharp lui-même, qui peut générer un avertissement indiquant qu'il pourrait ne pas correspondre avec .NET en raison de sa version plus ancienne. Les deux autres paquets sont System.Drawing.Common et System.Text.Encoding.CodePages.

L'orateur souligne que tous les trois packages doivent être installés avant de travailler avec PDFsharp ; sinon, le code générera une erreur. Ils expliquent que le paquet System.Text.Encoding.CodePages est particulièrement important car il fournit le support d'encodage nécessaire à la génération de fichiers PDF. L'orateur note également que l'échec de l'installation correcte des packages pourrait être difficile à résoudre. Les équipes souhaitant éviter complètement cette configuration multi-packages peuvent suivre le guide de migration de PDFsharp vers IronPDF pour une transition étape par étape.

Création d'un Fichier PDF

Ensuite, l'orateur présente une application console simple qui utilise PDFsharp pour générer un fichier PDF. Il explique qu'avant d'utiliser la bibliothèque, les déclarations using pour PDFsharp Drawing et PDFsharp PDF doivent être déclarées. L'orateur présente ensuite le code pour générer le fichier PDF, qui implique la création d'un nouveau document, l'ajout d'une nouvelle page et le dessin du texte sur la page.

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

Imports PdfSharp.Drawing
Imports PdfSharp.Pdf

Namespace PdfSharpExample
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a new PDF document
			Dim document As New PdfDocument()
			' Add a new page
			Dim page As PdfPage = document.AddPage()
			' Prepare to draw on the page
			Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
			' Define a font
			Dim font As New XFont("Verdana", 20, XFontStyle.Bold)

			' Draw a string to the page
			gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black, New XRect(0, 0, page.Width, page.Height), XStringFormats.Center)

			' Save the document
			Const filename As String = "HelloWorld.pdf"
			document.Save(filename)
		End Sub
	End Class
End Namespace

L'orateur souligne que le code de génération du fichier PDF peut être ajusté pour inclure des fonctionnalités plus complexes, telles que l'ajout d'images (voir comment convertir des images en PDF avec IronPDF), de tableaux et de graphiques. Ils expliquent également que PDFsharp propose diverses fonctionnalités pour travailler avec les polices, y compris l'intégration des polices dans le fichier PDF.

L'orateur explique l'importance de configurer correctement l'environnement en installant les paquets NuGet nécessaires et en enregistrant un fournisseur pour System.Text.Encoding. Ils présentent également une application console simple qui utilise PDFsharp pour générer un fichier PDF et démontre comment le code peut être ajusté pour inclure des fonctionnalités plus complexes. La vidéo est une excellente ressource pour quiconque s'intéresse à la génération de fichiers PDF en utilisant C# et PDFsharp.

Création de Listes et d'Éléments Plus Complexes

Dans la deuxième partie de la vidéo, l'orateur commence par introduire un exemple plus complexe de création d'un document PDF. Il souligne qu'il est inutile d'avoir un document PDF vide et procède à expliquer comment créer une nouvelle page en utilisant la bibliothèque PDFSharp. Il note que le processus est similaire à la création de choses dans des add-ins Excel ou PowerPoint, et qu'une fois la page créée, elle fonctionne avec une référence qui ne nécessite pas l'appel d'une autre méthode.

L'orateur présente ensuite la variable XGraphics, qui fournit des méthodes pour dessiner des éléments tels que du texte, des lignes et des images - une fonctionnalité qu'IronPDF gère via son API d'estampillage de texte et d'image sans nécessiter de calculs manuels de coordonnées. La variable XFont est également introduite comme moyen de configurer une police à utiliser dans le document PDF. L'orateur note que la police peut être générée ailleurs, mais qu'il est utile de la configurer globalement s'il y a une disposition plus complexe.

L'orateur aborde ensuite la méthode DrawString, qui permet d'écrire du texte dans le fichier PDF. Il note que la partie complexe de la méthode consiste à déterminer où le texte sera dessiné et explique les différents paramètres impliqués, tels que la police, la couleur et les limites de l'endroit où le texte peut s'aligner. Il explique également l'utilisation de la variable XBrushes pour définir la couleur du texte.

Quelle bibliothèque devriez-vous choisir ?

En conclusion, l'orateur souligne l'importance de se familiariser avec les compléments Microsoft Office lors du travail avecPDFSharpet propose son propre cours sur le sujet. Il note également que la bibliothèque est très polyvalente et peut être utilisée pour créer une large gamme de documents PDF, allant de simples documents texte à des documents plus complexes avec des images, des graphiques et des mises en page personnalisées.

Qu'est-ce qu'IronPDF?

IronPDF est une bibliothèque PDF C# permettant de créer, d'éditer et de manipuler des documents PDF . Il est livré sous la forme d'un seul paquet NuGet - Install-Package IronPdf - et s'intègre aux applications .NET sans nécessiter d'installation de dépendances supplémentaires.

PDFsharp offre un contrôle de dessin de bas niveau robuste et est distribué sous une licence MIT permissive — deux atouts indéniables qui en ont fait un élément incontournable de nombreux projets .NET . Les frictions entre les équipes surviennent souvent lorsque les exigences dépassent le simple rendu basé sur les coordonnées pour inclure des domaines tels que la conversion HTML vers PDF, les signatures numériques ou le chiffrement des documents.IronPDFest une bibliothèque commerciale qui traite ces scénarios comme des opérations de premier ordre, avec un support Professional et une interface API conçue autour des flux de travail courants de génération de documents, notamment le rendu HTML, CSS et JavaScript .

Caractéristiques

L'une des principales caractéristiques d'IronPDFest sa capacité à convertir du HTML en IronPDF , ce qui simplifie la création de documents PDF à partir de pages web. La conversion HTML vers PDF ne fait pas partie du périmètre actuel de PDFsharp — il fonctionne au niveau du dessin des coordonnées — les équipes ayant besoin de cette fonctionnalité ajoutent généralement une bibliothèque de rendu distincte ou évaluent le moteur Chromium intégré d'IronPDF.

IronPDF prend également en charge les signatures numériques et le chiffrement PDF avec protection par mot de passe , ce qui est essentiel pour les documents sensibles nécessitant une manipulation sécurisée. PDFsharp n'est pas conçu pour répondre à ces scénarios de sécurité, c'est pourquoi les équipes ayant des exigences en matière de conformité ou de protection des documents considèrent souvent cela comme un point d'inflexion naturel pour évaluer IronPDF.

IronPDF offre un ensemble de fonctionnalités plus étendu et une assistance plus complète que PDFsharp, couvrant le rendu HTML, le chiffrement et les signatures numériques dans un seul package NuGet . Il s'agit toutefois d'un produit commercial ; les équipes dont les exigences correspondent au modèle de dessin par coordonnées de PDFsharp — et qui n'ont pas besoin de conversion HTML ni de fonctionnalités de sécurité intégrées — pourraient préférer l'approche open source sous licence MIT de PDFsharp.

Au-delà du coût de la licence, le coût total du projet comprend les heures de développement consacrées à l'assemblage de bibliothèques de rendu distinctes, à la gestion des mises en page basées sur les coordonnées pour les documents complexes et au dépannage de la configuration multi-packages requise par PDFsharp. Pour les équipes évaluant les coûts sur un cycle de vie de projet pluriannuel, ces coûts d'intégration et de maintenance éclipsent fréquemment la différence entre les licences open source et commerciales.

Prêt à découvrir commentIronPDFs'intègre à votre flux de travail ? [Téléchargez une version d'évaluation gratuite de 30 jours (licence d'évaluation pour tester toutes les fonctionnalités couvertes par cette comparaison).