Erste Schritte

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

Ermöglicht Ihnen, HTML in PDF umzuwandeln (oder SVG/WEBP in PDF). Sie können das BitMiracle.Docotic.Pdf.HtmlToPdf-Paket von NuGet installieren. Oder fügen Sie manuell Verweise auf die folgenden DLLs aus dem ZIP-Paket hinzu:

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

Layout-Add-on

Verwenden Sie das Add-on, um PDF-Dokumente zu generieren aus einem im Code definierten Design. Verwenden Sie Bausteine wie Seiten, Container, Bilder, Textabsätze und dergleichen, um PDFs beliebiger Komplexität zu erstellen.

Das Layout-Add-on teilt Inhalte automatisch auf Seiten auf und bietet Unterstützung für Seitenkopf- und -fußzeilen, Tabellen und Absätze. Installieren Sie das BitMiracle.Docotic.Pdf.Layout-Paket von NuGet. Oder fügen Sie manuell Verweise auf die folgenden DLLs aus dem ZIP-Paket hinzu:

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

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.