Erste Schritte

Übersetzt von Bit Miracle. Originalartikel von Sergey Bobrovsky

Aktualisiert am 23. Juni 2026

Dieser Artikel erläutert einige Grundlagen, damit Sie mit der Docotic.Pdf-Bibliothek PDF-Dateien in Ihren .NET Core-, ASP.NET-, Windows Forms-, WPF-, Xamarin-, Blazor-, Unity- und HoloLens-Anwendungen verarbeiten können.

Installation der Docotic.Pdf-Bibliothek

Installation über NuGet

Der einfachste Weg für den Einstieg ist, das BitMiracle.Docotic.Pdf-Paket von NuGet zu installieren.

Bitte lesen Sie diesen Kurzanleitungsartikel, wenn Sie mit NuGet Manager noch nicht vertraut sind.

Manuelle Installation

Laden Sie die neueste Version herunter der Docotic.Pdf-Bibliothek von unserer Website. Wir stellen die Bibliothek als ZIP-Paket bereit. Das Paket enthält die Docotic.Pdf-Bibliothek, alle Beispielcodeprojekte, Bibliothekserweiterungen und Lizenzvereinbarungen.

Entpacken Sie das heruntergeladene ZIP-Paket an einem Ort Ihrer Wahl.

Öffnen Sie in Visual Studio das Dialogfeld Add Reference, navigieren Sie zu dem Ort, an dem Sie das ZIP-Paket entpackt haben, und wählen Sie dort die DLL aus.

Ausführen von Beispielcode

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

Sie können dieselben Codebeispiele aus unserem Repository mit Beispielcode auf GitHub klonen oder herunterladen.

Nehmen Sie sich bitte etwas Zeit, um die Codebeispiele durchzusehen. Das sollte Ihnen helfen, PDF-Verarbeitungsfunktionen zu Ihrer Anwendung hinzuzufügen.

Verwenden von Docotic.Pdf in Ihrem .NET-Projekt

Um das Tippen vollqualifizierter Namen der von der Bibliothek bereitgestellten Typen zu vermeiden, fügen Sie am besten die folgende using-Anweisung in Ihre C#-Quelldatei ein:

using BitMiracle.Docotic.Pdf;

In VB.NET verwenden Sie dies:

Imports BitMiracle.Docotic.Pdf

Fügen Sie in einem C#-Projekt Ihrer Anwendungsquelldatei die folgende Methode hinzu:

private static void helloPdf()
{
    // ersetzen Sie string.Empty durch Ihren Lizenzschlüssel
    BitMiracle.Docotic.LicenseManager.AddLicenseData(string.Empty);

    string outputName = "hello.pdf";
    // in einer ASP.NET-Anwendung verwenden Sie stattdessen die folgende Zeile:
    // string outputName = Server.MapPath("hello.pdf");

    using (PdfDocument pdf = new PdfDocument())
    {
        // zeichnet "Hello world" auf die erste Seite
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // öffnet das gespeicherte Dokument im standardmäßigen PDF-Viewer
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo() {
        FileName = outputName,
        UseShellExecute = true,
    });
}

Verwenden Sie in einem VB.NET-Projekt den folgenden Code:

Private Shared Sub helloPdf()
    ' ersetzen Sie string.Empty durch Ihren Lizenzschlüssel
    BitMiracle.Docotic.LicenseManager.AddLicenseData(String.Empty)

    Dim outputName As String = "hello.pdf"
    ' in einer ASP.NET-Anwendung verwenden Sie stattdessen die folgende Zeile:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' zeichnet "Hello world" auf die erste Seite
        Dim firstPage As PdfPage = pdf.Pages(0)
        firstPage.Canvas.DrawString(20, 20, "Hello world!")

        pdf.Save(outputName)
    End Using

    ' öffnet das gespeicherte Dokument im standardmäßigen PDF-Viewer
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

Rufen Sie die Methode helloPdf in Ihrem Code auf. Dadurch sollte die Datei hello.pdf erzeugt und im standardmäßigen PDF-Viewer geöffnet werden.

Add-ons

Sie können die Kernfunktionalität mit kostenlosen Add-ons erweitern.

HtmlToPdf-Add-on

Verwenden Sie das HtmlToPdf-Add-on, um HTML in PDF zu konvertieren. Das Add-on verwendet Google Chrome und dessen Blink-Rendering-Engine, daher ist die Unterstützung für HTML5, CSS3 und JavaScript sehr gut. Mit dem Add-on können Sie PDF aus HTML, SVG, WEBP und anderen Webformaten erzeugen.

Weitere Informationen zur vom Add-on bereitgestellten HTML-zu-PDF-API finden Sie im Überblick über seine Funktionen. Der Artikel erläutert, wie Sie das Add-on über NuGet oder manuell installieren. Er enthält außerdem Beispielcode.

Layout-Add-on

Verwenden Sie das Layout-Add-on, um PDFs aus strukturierten Layoutelementen zu erzeugen. Sie setzen Dokumente aus Textabschnitten, Bildern, Tabellen, Kopf- und Fußzeilen, Containern und optional wiederverwendbaren benutzerdefinierten Komponenten zusammen, und die Layout API ordnet alles für Sie an.

Statt Elemente an festen Koordinaten zu platzieren, beschreiben Sie komplette Dokumente im Code über eine klare, ausdrucksstarke API, die das Layout an Inhalt und Seitengröße anpasst. Die Layout-Engine übernimmt dann automatisch Paginierung, Verschachtelung und komplexe Strukturen. So lassen sich sowohl einfache Seiten als auch anspruchsvolle PDF-Berichte leicht erstellen.

Weitere Informationen zum Erzeugen von PDFs in .NET mit der Layout API finden Sie in dem Artikel, der die Funktionen ausführlich erläutert und Installationsanweisungen sowie Beispielcode enthält.

Gdi-Add-on

Ermöglicht das Drucken von PDF-Dokumenten oder das Zeichnen von PDF auf System.Drawing.Graphics. Sie können das BitMiracle.Docotic.Pdf.Gdi-Paket von NuGet installieren. Oder fügen Sie manuell Verweise auf die folgenden DLLs aus dem ZIP-Paket hinzu:

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

Logging-Add-on

Sie können es verwenden, um Informationen über die interne Struktur von PDF-Dokumenten zu protokollieren. Installieren Sie das BitMiracle.Docotic.Pdf.Logging-Paket von NuGet. Oder fügen Sie manuell Verweise auf die folgenden DLLs aus dem ZIP-Paket hinzu:

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

Abschluss

Jetzt sollten Sie in der Lage sein, mit der Docotic.Pdf-Bibliothek PDF-bezogene Funktionen in Ihren Anwendungen zu entwickeln. Das ist jedoch erst der Anfang. Wir empfehlen Ihnen, über die Funktionen der Bibliothek zu lesen und die Codebeispiele zu prüfen. Vielleicht möchten Sie sich auch den Bit Miracle-Blog ansehen.