Commencer

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

Vous permet de convertir HTML en PDF (ou SVG/WEBP en PDF). Vous pouvez installer le package BitMiracle.Docotic.Pdf.HtmlToPdf à partir de NuGet. Ou ajoutez manuellement des références aux DLL suivantes à partir du package ZIP :

• BitMiracle.Docotic.Pdf.dll
• HtmlToPdf add-on/BitMiracle.Docotic.Pdf.HtmlToPdf.dll
• HtmlToPdf add-on/Microsoft.Bcl.AsyncInterfaces.dll

Module complémentaire Layout

Utilisez le module complémentaire pour générer des documents PDF à partir d'une conception définie dans le code. Utilisez des blocs de construction tels que des pages, des conteneurs, des images, des paragraphes de texte, etc. pour créer des PDF de toute complexité.

Le module complémentaire de mise en page divise automatiquement le contenu en pages et prend en charge les en-têtes et pieds de page, les tableaux et les paragraphes. Installez le package BitMiracle.Docotic.Pdf.Layout à partir de NuGet. Ou ajoutez manuellement des références aux DLL suivantes à partir du package ZIP :

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

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.