Diese Seite kann automatisch übersetzten Text enthalten.

Erste Schritte

In diesem Artikel werden einige Grundlagen erläutert, damit Sie PDF-Dateien in Ihren WinForms-, Konsolen- oder ASP.NET-Anwendungen mit der Docotic.Pdf-Bibliothek verarbeiten können.

Erste Schritte mit Docotic.Pdf

Installieren der Docotic.Pdf-Bibliothek

Installation von NuGet

Der einfachste Einstieg besteht darin, das BitMiracle.Docotic.Pdf-Paket von NuGet zu installieren.

Bitte lesen Sie diesen Schnellstart-Artikel, wenn Sie neu bei NuGet Manager sind .

Manuelle Installation

  1. Laden Sie die neueste Version der Docotic.Pdf-Bibliothek von unserer Website herunter. Die Bibliothek wird als ZIP-Paket verteilt.
    Das ZIP-Paket enthält zwei Versionen der Bibliothek:
    • Version für .NET 4.0 und spätere Frameworks
    • Version für .NET Standard 2.0 und spätere Frameworks.

    Das ZIP-Paket enthält außerdem alle Beispielprojekte und die Datei mit der Lizenzvereinbarung.

  2. Extrahieren Sie das heruntergeladene ZIP-Paket an einen Speicherort Ihrer Wahl.

Laufende Proben

Docotic.Pdf-Beispiele befinden sich im Ordner „Samples“ des ZIP-Pakets. Öffnen Sie die Lösungsdatei SamplesCSharp, wenn Sie Beispielcode verwenden möchten, der in der Sprache C# geschrieben ist. Für eine VB.NET-Version öffnen Sie bitte die SamplesVB.NET-Lösungsdatei.

Derselbe Beispielcode kann geklont oder von unserem Beispiel-Repository auf GitHub heruntergeladen werden.

Bitte nehmen Sie sich die Zeit, die Muster anzusehen. Es soll Ihnen dabei helfen, PDF-Verarbeitungsfunktionen zu Ihrer Anwendung hinzuzufügen.

Verwenden von Docotic.Pdf in Ihrer WinForms-, Konsolen- oder ASP.NET-Anwendung

  1. Öffnen Sie die Visual Studio-IDE. Erstellen Sie ein neues Projekt oder öffnen Sie ein vorhandenes.

  2. Öffnen Sie das Dialogfeld „Referenz hinzufügen“ und fügen Sie einen Verweis auf BitMiracle.Docotic.Pdf.dll hinzu.

  • Die Erweiterungsliste enthält die BitMiracle.Docotic.Pdf-Assembly, wenn Sie die Bibliothek zu GAC hinzugefügt haben
  • Alternativ können Sie zu dem Speicherort navigieren, an dem Sie das ZIP-Paket extrahiert haben, und die DLL von dort auswählen.

Hinzufügen von Docotic.Pdf mithilfe des Dialogfelds „Referenz hinzufügen“.

Bitte beachten Sie, dass Sie einen NuGet-Verweis auf BitMiracle.Docotic.Pdf hinzufügen können, anstatt manuell auf dessen DLL zu verweisen.

Um auf Methoden und Eigenschaften zuzugreifen, die Interoperabilität mit Typen aus dem System.Drawing-Namespace und GDI+ bieten, müssen Sie einen Verweis auf die BitMiracle.Docotic.Pdf.Gdi-Erweiterungs-DLL hinzufügen. Sie finden die DLL im ZIP-Paket oder BitMiracle.Docotic.Pdf.Gdi-Paket von NuGet installieren.

Um HTML in PDF (oder SVG in PDF) zu konvertieren, müssen Sie einen Verweis auf die Erweiterungs-DLL BitMiracle.Docotic.Pdf.HtmlToPdf hinzufügen. Die DLL ist ebenfalls im ZIP-Paket enthalten, wir empfehlen jedoch, das BitMiracle.Docotic.Pdf.HtmlToPdf-Paket von NuGet zu installieren, anstatt die DLL manuell hinzuzufügen.

Um PDF-Dokumente mit der Layout-Engine zu erstellen, fügen Sie den Verweis auf die BitMiracle.Docotic.Pdf.Layout-Erweiterungs-DLL hinzu. Die Engine teilt Inhalte automatisch auf Seiten auf und bietet Unterstützung für Seitenkopf- und -fußzeilen, Tabellen und Absätze. Sie finden die DLL im ZIP-Paket, wir empfehlen jedoch, das BitMiracle.Docotic.Pdf.Layout-Paket von NuGet zu installieren, anstatt die DLL manuell hinzuzufügen.

  1. Um die Eingabe vollständiger Verweise auf die DLL zu vermeiden, fügen Sie am besten die folgende using-Anweisung zu den bereits vorhandenen in Ihrer Quelldatei in C# hinzu
    using BitMiracle.Docotic.Pdf;
    

    Verwenden Sie in VB.NET Folgendes:

    Imports BitMiracle.Docotic.Pdf
    
  2. Fügen Sie in einem C#-Projekt die folgende Methode zu Ihrem Anwendungsquellcode hinzu
private static void helloPdf()
{
    // replace string.Empty with your license key
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // in ASP.NET application please use following line instead:
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // draws "Hello world" on the first page
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // opens saved document in default PDF viewer
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

Verwenden Sie dies für ein VB.NET-Projekt

Private Shared Sub helloPdf()
    ' replace string.Empty with your license key
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' in ASP.NET application please use the following line instead:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' draws "Hello world" on the first page
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' opens saved document in the default PDF viewer
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub
  1. Rufen Sie die Methode helloPdf() aus Ihrem Code auf. Dadurch sollte die Datei „hello.pdf“ erstellt und in Ihrem Standard-PDF-Viewer geöffnet werden.

hello.pdf in einem Standard-PDF-Viewer

Abschluss

Jetzt sollten Sie in der Lage sein, mithilfe der Docotic.Pdf-Bibliothek PDF-bezogene Funktionen in Ihren Anwendungen zu entwickeln. Dies ist jedoch nur der Anfang. Wir empfehlen Ihnen, die der Bibliothek beiliegende Dokumentation durchzulesen und Beispiele zu prüfen. Vielleicht möchten Sie auch einen Blick auf den Bit Miracle-Blog werfen.