Premiers pas

Traduit par Bit Miracle. Article original de Sergey Bobrovsky

Mis à jour le 23 juin 2026

Cet article explique quelques notions de base pour vous permettre de commencer à traiter des fichiers PDF dans vos applications .NET Core, ASP.NET, Windows Forms, WPF, Xamarin, Blazor, Unity et HoloLens avec la bibliothèque Docotic.Pdf.

Installation de la bibliothèque Docotic.Pdf

Installation via NuGet

La manière la plus simple de démarrer est d’installer le package BitMiracle.Docotic.Pdf depuis NuGet.

Veuillez consulter cet article de démarrage rapide si vous débutez avec 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 projets d’exemples de code, les compléments de la bibliothèque et les accords de licence.

Extrayez le package ZIP téléchargé à l’emplacement de votre choix.

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

Exécution d’exemples de code

Le code d’exemple pour Docotic.Pdf se trouve dans le dossier Samples du package ZIP. Ouvrez le fichier de solution SamplesCSharp si vous souhaitez utiliser l’exemple de code écrit en C#. Pour une version VB.NET, ouvrez le fichier de solution SamplesVB.NET.

Vous pouvez cloner ou télécharger les mêmes exemples de code depuis notre dépôt d’exemples de code sur GitHub.

Prenez le temps d’examiner les exemples de code. Cela devrait vous aider à ajouter des fonctionnalités de traitement PDF à votre application.

Utilisation de Docotic.Pdf dans votre projet .NET

Pour éviter de taper les noms entièrement qualifiés 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;

En 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 une application ASP.NET, utilisez plutôt 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 une application ASP.NET, utilisez plutôt 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 depuis votre code. Cela devrait produire le fichier hello.pdf et l’ouvrir dans votre visionneuse PDF par défaut.

Compléments

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

Complément HtmlToPdf

Utilisez le complément HtmlToPdf pour convertir HTML en PDF. Le complément utilise Google Chrome et son moteur de rendu Blink, donc la prise en charge de HTML5, CSS3 et JavaScript est excellente. Vous pouvez générer des PDF à partir de HTML, SVG, WEBP et d’autres formats web à l’aide du complément.

Pour plus d’informations sur l’API HTML vers PDF fournie par le complément, lisez l’aperçu de ses fonctionnalités. L’article explique comment installer le complément via NuGet ou manuellement. Il inclut également du code d’exemple.

Complément Layout

Utilisez le complément Layout pour générer des PDF à partir d’éléments de mise en page structurés. Vous composez des documents à partir de spans de texte, d’images, de tableaux, d’en-têtes, de pieds de page, de conteneurs et, éventuellement, de composants personnalisés réutilisables, et la Layout API organise tout pour vous.

Au lieu de placer les éléments à des coordonnées fixes, vous décrivez des documents entiers en code à l’aide d’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. Cela facilite la création de tout type de document, de simples pages à des rapports PDF sophistiqués.

Pour plus d’informations sur la génération de PDF dans .NET avec la Layout API, lisez l’article qui explique ses fonctionnalités en détail et inclut les instructions d’installation ainsi que du code d’exemple.

Complément Gdi

Permet d’imprimer des documents PDF ou de dessiner du PDF sur System.Drawing.Graphics. Vous pouvez installer le package BitMiracle.Docotic.Pdf.Gdi depuis NuGet. Ou ajouter manuellement des références aux DLL suivantes depuis le package ZIP :

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

Complément Logging

Vous pouvez l’utiliser pour journaliser des informations sur la structure interne des documents PDF. Installez le package BitMiracle.Docotic.Pdf.Logging depuis NuGet. Ou ajoutez manuellement des références aux DLL suivantes depuis le 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 maintenant pouvoir développer des fonctionnalités liées au PDF dans vos applications à l’aide de la bibliothèque Docotic.Pdf. Ce n’est toutefois qu’un début. Nous vous encourageons à lire la documentation sur les fonctionnalités de la bibliothèque et à examiner les exemples de code. Vous pouvez également consulter le blog Bit Miracle.