Erste Schritte

Übersetzt von Bit Miracle. Originalartikel von Sergey Bobrovsky

Aktualisiert am 27. Februar 2026

In diesem Artikel werden einige Grundlagen erläutert, die Ihnen den Einstieg in die Verarbeitung von PDF-Dateien in Ihren .NET Core-, ASP.NET-, Windows Forms-, WPF-, Xamarin-, Blazor-, Unity- und HoloLense-Anwendungen mit der Docotic.Pdf-Bibliothek erleichtern.

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

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

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

Öffnen Sie in Visual Studio das Dialogfeld „Referenz hinzufügen“, navigieren Sie zu dem Speicherort, an dem Sie das ZIP-Paket extrahiert haben, und wählen Sie dort die DLL aus.

Beispielcode ausführen

Codebeispiele für Docotic.Pdf 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 Lösungsdatei SamplesVB.NET.

Sie können dieselben Codebeispiele von unserem Beispielcode-Repository auf GitHub klonen oder herunterladen.

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

Verwenden von Docotic.Pdf in Ihrem .NET-Projekt

Um die Eingabe vollständig qualifizierter Namen der von der Bibliothek bereitgestellten Typen zu vermeiden, fügen Sie Ihrer C#-Quelldatei am besten die folgende using-Anweisung hinzu:

using BitMiracle.Docotic.Pdf;

Verwenden Sie in VB.NET Folgendes:

Imports BitMiracle.Docotic.Pdf

Fügen Sie in einem C#-Projekt die folgende Methode zu Ihrem Anwendungsquellcode hinzu:

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

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

    using (PdfDocument pdf = new PdfDocument())
    {
        // Zeichnet „Hello world“ auf der ersten Seite
        PdfPage firstPage = pdf.Pages[0];
        firstPage.Canvas.DrawString(20, 20, "Hello world!");

        pdf.Save(outputName);
    }

    // Öffnet das gespeicherte Dokument im Standard-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 der ASP.NET-Anwendung verwenden Sie bitte stattdessen die folgende Zeile:
    ' Dim outputName As String = Server.MapPath("hello.pdf")

    Using pdf As New PdfDocument()
        ' Zeichnet „Hello world“ auf der ersten 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 Standard-PDF-Viewer
    System.Diagnostics.Process.Start(
        New ProcessStartInfo() With {
            .FileName = outputName,
            .UseShellExecute = True
        }
    )
End Sub

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.

Add-ons

You can extend the core functionality with free add-ons.

HtmlToPdf-Add-on

Mit dem Add-on HtmlToPdf können Sie HTML in PDF konvertieren. Das Add-on nutzt Google Chrome und dessen Blink-Rendering-Engine und bietet daher hervorragende Unterstützung für HTML5, CSS3 und JavaScript. Sie können mit dem Add-on PDFs aus HTML, SVG, WEBP und anderen Webformaten generieren.

Weitere Informationen zur HTML-zu-PDF-API des Add-ons finden Sie in der Funktionsübersicht. Der Artikel erklärt die Installation des Add-ons über NuGet oder manuell und enthält Beispielcode.

Layout-Add-on

Mit dem Layout-Add-on können Sie PDFs aus strukturierten Layout-Elementen generieren. Sie erstellen Dokumente aus Textabschnitten, Bildern, Tabellen, Kopf- und Fußzeilen, Containern und optional wiederverwendbaren benutzerdefinierten Komponenten. Die intuitive Layout-API kümmert sich um die komplette Anordnung.

Anstatt Elemente an festen Koordinaten zu platzieren, beschreiben Sie ganze Dokumente im Code mithilfe einer übersichtlichen und ausdrucksstarken API, die das Layout an Inhalt und Seitengröße anpasst. Die Layout-Engine kümmert sich anschließend automatisch um Paginierung, Verschachtelung und komplexe Strukturen. So lassen sich mühelos sowohl einfache Seiten als auch anspruchsvolle PDF-Berichte erstellen.

Weitere Informationen zum Generieren 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 PDFs 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 damit Informationen über die interne Struktur von PDF-Dokumenten 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, mithilfe der Docotic.Pdf-Bibliothek PDF-bezogene Funktionen in Ihren Anwendungen zu entwickeln. Wir empfehlen Ihnen, über die Funktionen der Bibliothek zu lesen und Codebeispiele durchzusehen. Vielleicht möchten Sie auch einen Blick auf den Bit Miracle-Blog werfen.