Commencer

Traduit par Bit Miracle. Article original de Sergey Bobrovsky

Mis à jour le 27 février 2026

Cet article explique quelques bases pour vous aider à traiter les fichiers PDF dans vos applications .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity et HoloLense avec la bibliothèque Docotic.Pdf.

Installation de la bibliothèque Docotic.Pdf

Installation à partir de NuGet

Le moyen le plus simple de commencer consiste à installer le package BitMiracle.Docotic.Pdf à partir de NuGet.

Veuillez vous référer à cet article de démarrage rapide si vous êtes nouveau sur NuGet Manager.

Installation manuelle

Téléchargez la dernière version de la bibliothèque Docotic.Pdf depuis notre site. Nous distribuons la bibliothèque sous forme de package ZIP. Le package contient la bibliothèque Docotic.Pdf, tous les exemples de projets de code, les modules complémentaires de bibliothèque et les accords de licence.

Extrayez le package ZIP téléchargé vers un emplacement de votre choix.

Dans Visual Studio, ouvrez la boîte de dialogue Ajouter une référence, accédez à l'emplacement où vous avez extrait le package ZIP et sélectionnez la DLL à partir de là.

Exécution d'un exemple de code

Les exemples de code pour Docotic.Pdf se trouvent dans le dossier Samples du package ZIP. Ouvrez le fichier de solution SamplesCSharp si vous souhaitez utiliser un exemple de code écrit en langage C#. Pour une version VB.NET, veuillez ouvrir le fichier de solution SamplesVB.NET.

Vous pouvez cloner ou télécharger les mêmes exemples de code à partir de notre référentiel d'exemples de code sur GitHub.

Veuillez prendre le temps de consulter les exemples de code. Cela devrait vous aider à ajouter des fonctionnalités de traitement PDF à votre application.

Utiliser Docotic.Pdf dans votre projet .NET

Pour éviter de saisir des noms complets des types fournis par la bibliothèque, il est préférable d'ajouter la directive using suivante à votre fichier source C# :

using BitMiracle.Docotic.Pdf;

Dans VB.NET, utilisez ceci :

Imports BitMiracle.Docotic.Pdf

Dans un projet C#, ajoutez la méthode suivante au code source de votre application :

private static void helloPdf()
{
    // remplacez string.Empty par votre clé de licence
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // dans l'application ASP.NET, veuillez utiliser la ligne suivante :
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // dessine "Hello world" sur la première page
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // ouvre le document enregistré dans la visionneuse PDF par défaut
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

Dans un projet VB.NET, utilisez le code suivant :

Private Shared Sub helloPdf()
    ' remplacez string.Empty par votre clé de licence
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' dans l'application ASP.NET, veuillez utiliser la ligne suivante :
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' dessine "Hello world" sur la première page
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' ouvre le document enregistré dans la visionneuse PDF par défaut
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

Appelez la méthode helloPdf à partir de votre code. Cela devrait produire le fichier hello.pdf et l'ouvrir dans votre visionneuse PDF par défaut.

Modules complémentaires

Vous pouvez étendre les fonctionnalités de base avec des modules complémentaires gratuits.

Module complémentaire HtmlToPdf

Utilisez l'extension HtmlToPdf pour convertir du HTML en PDF. Cette extension utilise Google Chrome et son moteur de rendu Blink, offrant ainsi une excellente compatibilité avec HTML5, CSS3 et JavaScript. Vous pouvez générer des PDF à partir de HTML, SVG, WEBP et d'autres formats web grâce à cette extension.

Pour plus d'informations sur l'API HTML vers PDF fournie par l'extension, consultez la présentation de ses fonctionnalités. Cet article explique comment installer l'extension via NuGet ou manuellement. Il contient également des exemples de code.

Module complémentaire Layout

Utilisez l'extension Layout pour générer des PDF à partir d'éléments de mise en page structurés. Vous composez des documents à partir de blocs de texte, d'images, de tableaux, d'en-têtes, de pieds de page, de conteneurs et, éventuellement, de composants personnalisés réutilisables ; l'API Layout, fluide et intuitive, se charge ensuite de tout agencer.

Au lieu de positionner les éléments à des coordonnées fixes, vous décrivez des documents entiers par le biais du code, grâce à une API claire et expressive qui adapte la mise en page au contenu et à la taille de la page. Le moteur de mise en page gère ensuite automatiquement la pagination, l'imbrication et les structures complexes. Il devient ainsi facile de produire aussi bien des pages simples que des rapports PDF sophistiqués.

Pour plus d'informations sur la génération de PDF en .NET avec l'API Layout, consultez l'article qui explique ses fonctionnalités en détail et comprend des instructions d'installation et un exemple de code.

Module complémentaire Gdi

Vous permet d'imprimer des documents PDF ou de dessiner des PDF sur System.Drawing.Graphics. Vous pouvez installer le package BitMiracle.Docotic.Pdf.Gdi à partir de NuGet. Ou ajoutez manuellement des références aux DLL suivantes à partir du package ZIP :

• BitMiracle.Docotic.Pdf.dll
• Gdi add-on/BitMiracle.Docotic.Pdf.Gdi.dll

Module complémentaire Logging

Vous pouvez l'utiliser pour enregistrer des informations sur la structure interne des documents PDF. Installez le package BitMiracle.Docotic.Pdf.Logging à partir de NuGet. Ou ajoutez manuellement des références aux DLL suivantes à partir du package ZIP :

• BitMiracle.Docotic.Pdf.dll
• Logging add-on/BitMiracle.Docotic.Pdf.Logging.dll
• Logging add-on/Microsoft.Extensions.Logging.Abstractions.dll

Conclusion

Vous devriez désormais pouvoir développer des fonctionnalités liées au PDF dans vos applications à l'aide de la bibliothèque Docotic.Pdf. Mais ce n’est qu’un début. Nous vous encourageons à en savoir plus sur les fonctionnalités de la bibliothèque et à consulter des exemples de code. Vous pouvez également consulter le blog Bit Miracle.