Comment créer un fichier PDF dans C# à l'aide de Xceed PdfLibrary pour .NET

La génération de PDF à partir de votre application .NET est un besoin courant : rapports, factures ou documents que les utilisateurs peuvent imprimer ou partager. Le faire en code vous donne un contrôle total sur la mise en page, le texte et la structure, sans édition manuelle ni outils externes.

Ce guide vous explique étape par étape comment créer un fichier PDF dans C# : vous allez créer un fichier PDF simple comprenant un titre et un corps de texte à l'aide de Xceed PdfLibrary pour .NET. À la fin, vous aurez un extrait de code exécutable, comprendrez l'API principale et saurez où trouver des exemples pour les signets, les filigranes et plus encore.

Ce dont tu as besoin

• .NET 5 à .NET 10
• L'assembly Xceed PdfLibrary pour .NET (essai ou licence). Ajoutez-la via NuGet ou référencez la DLL à partir de votre projet.
• Quelques minutes

Configurer le projet et la licence

Créez un projet de console ou web et ajoutez la bibliothèque. Depuis la ligne de commande (.NET CLI):

dotnet add package Xceed.PdfLibrary.NET

Dans Visual Studio, vous pouvez utiliser le gestionnaire de packages NuGet ou naviguer vers Xceed.PdfLibrary.NET sur NuGet.

Octroi de licences : Xceed PdfLibrary requiert une clé de licence (d'essai ou achetée) avant de pouvoir créer ou charger un PDF. Obtenez une clé d'essai gratuite ou une licence complète de la page produit.

Définissez la clé une fois au démarrage de l'application, avant toute DocumentPdf appels :

using Xceed.PdfLibrary.NET;

// Set the license key once at startup (e.g. in your app's entry point)
Licenser.LicenseKey = "YOUR-TRIAL-OR-PURCHASED-KEY";

using var doc = PdfDocument.Create("output.pdf");
// ... rest of your code

Créer et enregistrer un PDF

Pour créer un fichier PDF dans C# après avoir importé la bibliothèque, appelez PdfDocument.Create(chemin). Le chemin peut être relatif (par exemple. “output.pdf”, écrite dans le répertoire actuel de votre application) ou un chemin complet. Le document commence par une page ; obtenez-la avec doc.Pages.Premier(). À partir de là, vous ajoutez un titre et une ligne de texte.

using var doc = PdfDocument.Create("output.pdf");
var page = doc.Pages.First();
var style = TextStyle.WithFont(doc.Fonts.GetStandardFont(StandardFontType.Helvetica), 18);
page.AddParagraph("Hello from the blog", style, new ParagraphStyle(ParagraphHorizontalAlignment.Center));
page.AddText("This PDF was created with Xceed PdfLibrary for .NET.", new Point(50, 120));
doc.Save();

Le code crée un fichier, ajoute un titre centré et une ligne de texte à la position (50, 120), puis enregistre. Les coordonnées sont en points (72 par pouce), avec l'origine en haut à gauche de la page et Y augmentant vers le bas.

AjouterParagraphe convient aux titres et aux blocs qui peuvent passer à la ligne ; AjouterTexte place une ligne unique à un point donné. Copiez l'extrait ci-dessus dans votre propre console ou projet web et exécutez-le.

Quand utiliser AddParagraph par rapport à AddText

Utiliser AjouterParagraphe lorsque vous avez un bloc de texte (un titre ou un paragraphe) qui doit s'ajuster dans des marges ou un rectangle. Vous pouvez définir l'alignement (gauche, centre, droite) via StyleParagraphe. Par exemple, les titres de rapport et les paragraphes de corps sont de bons candidats pour AjouterParagraphe.

Utiliser AjouterTexte lorsque vous avez besoin d'une seule ligne à une position exacte, par exemple pour des étiquettes, des pieds de page ou des extraits positionnés tels que “Page 1 sur 5”. Les deux méthodes acceptent un StyleDeTexte pour la police, la taille et la couleur. Choisir la bonne méthode permet de garder la mise en page prévisible et d'éviter les sauts de ligne manuels.

Ajoutez plus de pages et de contenu

De nouvelles pages sont ajoutées avec doc.Pages.Ajouter(). Vous récupérez la nouvelle page et ajoutez du contenu de la même manière : AjouterParagraphe, AjouterTexte, ou plus tard AjouterImage, champs de formulaire, etc. L'API est la même pour chaque page, ainsi la création d'un rapport multi-pages se résume à une boucle et à l'ajout de contenu.

Par exemple, boucle de 0 à N, appelez Ajouter(), puis ajoutez un titre et un corps de texte à chaque nouvelle page. Les documents multipages sont utiles pour les rapports, les factures avec des pages détaillées, ou tout contenu qui dépasse une seule feuille.

La même AjouterParagraphe et AjouterTexte les appels fonctionnent sur chaque page ; vous n'avez besoin de suivre la position verticale (Y) que si vous souhaitez faire défiler le contenu vers le bas de la page.

Vous pouvez définir la taille de page et les marges par défaut lors de la création du document ou par page. Xceed PdfLibrary utilise un système de coordonnées dont l'origine est en haut à gauche ; Y augmente vers le bas. Cela correspond à la façon dont de nombreuses autres API de documents fonctionnent et est facile à appréhender pour les en-têtes, les pieds de page et les colonnes.

Si vous avez besoin d'une taille de page différente (par exemple, A5 ou légal), configurez-la lors de la création du document ou sur la page avant d'ajouter du contenu.

Styling : polices et couleurs

Choisissez la police et la taille via TextStyle.AvecPolice ou AvecPoliceEtCouleur pour le texte en couleur). Les polices PDF standard comme Helvetica, Helvetica-Bold et Times sont intégrées. Pour une image de marque personnalisée ou des langues, vous pouvez intégrer des polices TrueType à partir d'un chemin de fichier ou d'un flux. Pour les paragraphes centrés ou alignés à droite, passez un StyleParagraphe avec l'alignement que vous souhaitez.

Mélanger les polices et les tailles dans le même document est simple : créez une StyleDeTexte par combinaison et le transmettre à AjouterParagraphe ou AjouterTexte.

La bibliothèque fonctionne avec .NET 5 à .NET 10 et s'exécute sur Windows, macOS et Linux. Le même code fonctionne dans les applications de bureau, ASP.NET ou d'autres environnements hôtes.

Exécutez le code

Collez les extraits ci-dessus dans une console ou un projet web, définissez votre clé de licence et exécutez. Le PDF est écrit dans le chemin que vous avez passé à PdfDocument.Créer par exemple,. output.pdf). Depuis Visual Studio, le répertoire courant est généralement le dossier du projet ; depuis la ligne de commande, c'est le dossier à partir duquel vous avez appelé l'application.

Ouvrez le fichier généré dans n'importe quel visualiseur de PDF pour confirmer que le titre et le texte apparaissent comme prévu. Si le fichier ne se trouve pas là où vous l'attendez, utilisez un chemin absolu (par exemple,. Path.Combine(AppContext.BaseDirectory, “output.pdf”)) ou vérifiez votre répertoire de travail dans le débogueur.

Questions courantes

Dois-je jeter le document ? Oui. Utiliser en utilisant (comme dans l'extrait) ou appeler Disposer les descripteurs de fichiers et les flux sont ainsi libérés.

Puis-je enregistrer dans un flux au lieu d'un fichier ? Oui. Utiliser les surcharges qui acceptent un Flux pour la création ou EnregistrerSous(flux) lors de la sauvegarde. C'est utile lors de la génération de PDF en mémoire pour les réponses web ou les API.

Puis-je créer un PDF en mémoire sans fichier ? Oui. Créez le document avec un Flux par exemple,. MemoryStream) et appeler Économisez ou Sauvegarde pour écrire dans ce flux. Vous pouvez ensuite utiliser le tampon pour les téléchargements ou les réponses.

Que faire si j'obtiens une erreur de licence ou de fichier ? Fixer Licenser.CléDeLicence avant toute chose DocumentPdf Appel. Si le PDF n'est pas trouvé après l'exécution, vérifiez que le chemin est relatif au répertoire courant de votre processus ou utilisez un chemin absolu.

Où puis-je voir plus d'exemples ? Voir le Documentation de Xceed PdfLibrary pour .NET pour des sujets avancés et plus d'exemples.

Puis-je utiliser ceci dans une application ASP.NET Core ? Yes. The same code runs in any .NET host. Set the license key at startup (e.g. in Program.cs or when building the host), then create or load PDFs in your controllers or services. For web responses, create the document with a MemoryStream and return it with the appropriate Content-Type: application/pdf header.

Résumé : You’ve seen how to create a PDF in C#: install the package, set the license key once at startup, then use PdfDocument.Créer, Pages, AjouterParagrapheet AjouterTexte to build your first PDF.

Que pouvez-vous faire d'autre avec Xceed PdfLibrary ?

With Xceed PdfLibrary for .NET you can add bookmarks, hyperlinks, images, and form fields (text boxes, checkboxes, signature fields). You can load an existing PDF, modify it, and save to a new file, or extract text and metadata. The same patterns you used here (create or load, get pages, add content, save) apply across these features.

Once you’re comfortable with how to create a PDF in C#, try adding images or form fields using the same document and page API.

Next steps

• Download Xceed PdfLibrary for .NET ou get a free trial key
• Install via NuGet: Xceed.PdfLibrary.NET – .NET CLI:
• Learn how to extract content from a PDF in C#!

dotnet add package Xceed.PdfLibrary.NET