Diese Seite kann automatisch übersetzten Text enthalten.
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.
9.5.17573-dev 14,726 bestanden NuGet-Downloads insgesamt 4,765,230Manuelle 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
9.5.17573-devErmö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
9.5.17573-devVerwenden 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
9.5.17573-devErmö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
9.5.17573-devSie 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.