Cette page peut contenir du texte traduit automatiquement.

Commencer

Cet article explique certaines des bases pour vous aider à traiter les fichiers PDF dans vos applications WinForms, console ou ASP.NET avec la bibliothèque Docotic.Pdf.

Premiers pas avec 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

  1. Téléchargez la dernière version de la bibliothèque Docotic.Pdf depuis notre site. La bibliothèque est distribuée sous forme de package ZIP.
    Le package ZIP contient deux versions de la bibliothèque :
    • version pour les frameworks .NET 4.0 et versions ultérieures
    • version pour les frameworks .NET Standard 2.0 et versions ultérieures.

    Le package ZIP contient également tous les exemples de projets ainsi que le fichier contenant le contrat de licence.

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

Exécution d'exemples

Les exemples 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.

Le même exemple de code peut être cloné ou téléchargé à partir de notre référentiel d'exemples sur GitHub.

Veuillez prendre le temps d'examiner les échantillons. Cela devrait vous aider à ajouter des fonctionnalités de traitement PDF à votre application.

Utilisation de Docotic.Pdf dans votre application WinForms, console ou ASP.NET

  1. Ouvrez l’EDI Visual Studio. Créez un nouveau projet ou ouvrez-en un existant.

  2. Ouvrez la boîte de dialogue Ajouter une référence et ajoutez une référence à BitMiracle.Docotic.Pdf.dll.

    • La liste Extensions contiendra l'assembly BitMiracle.Docotic.Pdf si vous avez ajouté la bibliothèque au GAC
    • Vous pouvez également accéder à l'emplacement où vous avez extrait le package ZIP et sélectionner la DLL à partir de là.

Ajout de Docotic.Pdf à l'aide de la boîte de dialogue Ajouter une référence

Veuillez noter que vous pouvez ajouter une référence NuGet à BitMiracle.Docotic.Pdf au lieu de référencer sa DLL manuellement.

Pour accéder aux méthodes et aux propriétés qui assurent l'interopérabilité avec les types de l'espace de noms System.Drawing et GDI+, vous devez ajouter une référence à la DLL d'extension BitMiracle.Docotic.Pdf.Gdi. Vous pouvez trouver la DLL dans le package ZIP ou installer le package BitMiracle.Docotic.Pdf.Gdi à partir de NuGet.

Pour convertir du HTML en PDF (ou du SVG en PDF), vous devez ajouter une référence à la DLL d'extension BitMiracle.Docotic.Pdf.HtmlToPdf. La DLL se trouve également dans le package ZIP mais nous vous recommandons d'installer le package BitMiracle.Docotic.Pdf.HtmlToPdf à partir de NuGet au lieu d'ajouter la DLL manuellement.

Pour créer des documents PDF à l'aide du moteur de mise en page, ajoutez la référence à la DLL d'extension BitMiracle.Docotic.Pdf.Layout. Le moteur divise automatiquement le contenu en pages et prend en charge les en-têtes et pieds de page, les tableaux et les paragraphes. Vous pouvez trouver la DLL dans le package ZIP mais nous vous recommandons d'installer le package BitMiracle.Docotic.Pdf.Layout à partir de NuGet au lieu d'ajouter la DLL manuellement.

  1. Pour éviter de saisir des références complètes à la dll, il est préférable d'ajouter l'instruction using suivante à celles déjà existantes dans votre fichier source en C#
    using BitMiracle.Docotic.Pdf;
    

    Dans VB.NET, utilisez ceci :

    Imports BitMiracle.Docotic.Pdf
    
  2. 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,
    });
}

Pour un projet VB.NET, utilisez ceci

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
  1. Appelez la méthode helloPdf() à partir de votre code. Cela devrait produire un fichier hello.pdf et l'ouvrir dans votre visionneuse PDF par défaut.

hello.pdf dans une visionneuse PDF par défaut

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 à lire la documentation accompagnant la bibliothèque et à examiner des échantillons. Vous pouvez également consulter le blog Bit Miracle.