PDF-Erzeugung in C# (.NET 5) mit PDFSharp

Einführung

Das Video ist eine Anleitung zur Verwendung der PDFsharp-Bibliothek, um mit C#-Code eine PDF-Datei zu erzeugen. Der Referent beginnt mit der Vorstellung von PDFsharp, einer kniffligen, aber effektiven Bibliothek zur Erzeugung von PDF-Dateien. Die Bibliothek verfügt über fortschrittliche Funktionen und ist im Gegensatz zu vielen ihrer Konkurrenten völlig kostenlos. Der Referent betont, dass PDFsharp trotz seiner Komplexität eine ausgezeichnete Wahl für die Erzeugung von PDF-Dateien mit C# ist.

Zu Beginn des Tutorials präsentiert der Referent ein Beispiel für eine generierte PDF-Datei, die aus drei Textzeilen besteht. Die erste Textzeile ist nicht genau die erste, während die dritte Textzeile in der rechten unteren Ecke erscheint. Der Sprecher weist darauf hin, dass die Reihenfolge des Textes einen Sinn ergibt, sobald sie in den Code einsteigen. Sie erklären auch, dass sie .NET 5 verwenden werden, um zu demonstrieren, wie PDFsharp funktioniert.

Installation und Einrichtung

Bevor er auf den Code eingeht, weist der Referent darauf hin, dass das Einrichten der Umgebung für PDFsharp recht anspruchsvoll sein kann. Sie erklären, dass drei NuGet-Pakete installiert werden müssen, bevor Sie mit PDFsharp NuGet Package Details arbeiten können. Das erste Paket ist PDFsharp selbst, das möglicherweise eine Warnung erzeugt, dass es aufgrund seiner älteren Version nicht mit .NET kompatibel ist. Die beiden anderen Pakete sind Common System.Drawing.Common und System.Text.Encoding.CodePages.

Der Referent betont, dass alle drei Pakete vor der Arbeit mit PDFsharp installiert sein müssen, da der Code sonst einen Fehler ausgibt. Sie erklären, dass das CodePages-Paket besonders wichtig ist, da es die für die Erstellung von PDF-Dateien erforderliche Kodierungsunterstützung bietet. Der Referent weist auch darauf hin, dass eine fehlgeschlagene Installation der Pakete komplex ist und die Fehlerbehebung schwierig sein kann.

Installieren von verwandten Bibliotheken

Um PDFSharp ordnungsgemäß funktionieren zu lassen, erklärt der Sprecher, dass ein Anbieter für System.Text.Encoding registriert werden muss. Der Anbieter stammt aus dem CodePages-Paket, und der Referent betont, wie wichtig es ist, das Paket zu registrieren, um sicherzustellen, dass PDFSharp korrekt funktioniert. Sie erklären, dass die Nichtregistrierung des Anbieters zu einem Fehler führt und die Fehlerbehebung schwierig sein kann.

Erstellen einer PDF-Datei

Als Nächstes stellt der Referent eine einfache Konsolenanwendung vor, die PDFSharp verwendet, um eine PDF-Datei zu erzeugen. Er erklärt, dass vor der Verwendung der Bibliothek die using-Anweisungen für PDFSharp Drawing und PDFSharp PDF deklariert werden müssen. Anschließend stellt der Referent den Code für die Erstellung der PDF-Datei vor, d. h. er erstellt ein neues Dokument, fügt eine neue Seite hinzu und zeichnet den Text auf die Seite.

Der Referent weist darauf hin, dass der Code für die Erstellung der PDF-Datei angepasst werden kann, um komplexere Funktionen wie das Hinzufügen von Bildern, Tabellen und Diagrammen zu ermöglichen. Sie erklären auch, dass PDFSharp verschiedene Funktionen für die Arbeit mit Schriftarten bietet, einschließlich der Einbettung von Schriftarten in die PDF-Datei.

Der Sprecher erklärt die Wichtigkeit der korrekten Einrichtung der Umgebung durch die Installation der notwendigen NuGet-Pakete und die Registrierung eines Anbieters für System.Text.Encoding. Sie stellen auch eine einfache Konsolenanwendung vor, die PDFsharp zur Generierung einer PDF-Datei verwendet, und zeigen, wie der Code angepasst werden kann, um komplexere Funktionen einzubeziehen. Das Video ist eine hervorragende Ressource für alle, die sich für die Erstellung von PDF-Dateien mit C# und PDFsharp interessieren.

Erstellen von Listen und komplexeren Elementen

Im zweiten Teil des Videos stellt der Referent zunächst ein komplexeres Beispiel für die Erstellung eines PDF-Dokuments vor. Er betont, dass es sinnlos ist, ein leeres PDF-Dokument zu haben und erklärt, wie man mit der PDFSharp-Bibliothek eine neue Seite erstellt. Er stellt fest, dass der Prozess dem Erstellen von Inhalten in Excel- oder PowerPoint-Add-Ins ähnelt und dass die Seite, sobald sie erstellt ist, mit einer Referenz funktioniert, die nicht die Aufrufung einer anderen Methode erfordert.

Der Sprecher stellt dann die Variable XGraphics vor, die Methoden bereitstellt, um Dinge wie Text, Linien und Bilder zu zeichnen. Die XFont-Variable wird ebenfalls eingeführt, um eine Schriftart für die Verwendung im PDF-Dokument einzurichten. Der Referent weist darauf hin, dass die Schriftart auch an anderer Stelle generiert werden kann, dass es aber sinnvoll ist, sie global einzurichten, wenn eine komplexere Anordnung vorliegt.

Als nächstes bespricht der Sprecher die DrawString-Methode, die Text in die PDF-Datei schreibt. Er bemerkt, dass der komplexe Teil der Methode darin besteht, zu bestimmen, wo der Text gezeichnet wird, und erklärt die verschiedenen Parameter, die dabei eine Rolle spielen, wie Schriftart, Farbe und die Begrenzungen, in denen der Text ausgerichtet werden könnte. Er erklärt auch die Verwendung der Variable XBrushes, um die Farbe des Textes festzulegen.

Erklärung von DrawString und anderen Methoden

Der Sprecher präsentiert dann mehrere Beispiele für die Verwendung der DrawString-Methode mit verschiedenen Parametern, wie zum Beispiel das Ausrichten des Textes in der Mitte, das Ausrichten unten links und das Festlegen der genauen Koordinaten, an denen der Text platziert wird. Er stellt fest, dass die letzte Option am anpassbarsten ist und ein hohes Maß an Flexibilität bietet.

Der Referent erklärt, wie man eine Tabelle mit Hilfe von Grafiken in der Programmiersprache C# erstellt. Sie behandeln das Einfügen von Bildern, Zeichenketten und Linien sowie das Zeichnen von Bögen und Strichcodes mithilfe der Grafikfunktion. Sie erklären auch die Bedeutung von Versuch und Irrtum bei der Arbeit mit Koordinaten und wie man Linien zur Trennung von Reihen zieht.

Der Referent geht auch auf den Tabellenkopf und die Notwendigkeit eines Ausgangspunkts für Werte und die Zeile ein. Es wird erklärt, wie man die y-Position anpasst und Datensatzzeilen hinzufügt, und wie man auf eine andere Seite wechselt, wenn die Tabelle eine bestimmte Anzahl von Datensätzen überschreitet. Schließlich weisen sie darauf hin, wie wichtig es ist, die Werte für jede Seite zurückzusetzen.

Schlussfolgerung

Abschließend betont der Referent, wie wichtig es ist, mit Microsoft Office Add-Ins vertraut zu sein, wenn man mit PDFSharp arbeitet, und bietet seinen eigenen Kurs zu diesem Thema an. Er weist auch darauf hin, dass die Bibliothek sehr vielseitig ist und zur Erstellung einer breiten Palette von PDF-Dokumenten verwendet werden kann, von einfachen Textdokumenten bis hin zu komplexeren Dokumenten mit Bildern, Grafiken und benutzerdefinierten Layouts.

IronPDF: Eine C# PDF-Bibliothek

IronPDF ist eine C# PDF-Bibliothek zum Erstellen, Bearbeiten und Manipulieren von PDF-Dokumenten. Es ist einfach zu bedienen und lässt sich nahtlos in .NET-Anwendungen integrieren.

Im Vergleich zu PDF Sharp bietet IronPDF mehrere Vorteile. Erstens ist es ein kommerzielles Produkt und wird mit professionellem Support geliefert, der bei PDF Sharp nicht verfügbar ist. Zweitens verfügt IronPDF über eine bessere Dokumentation und eine intuitivere API, die Entwicklern den Einstieg und die Arbeit mit der Bibliothek erleichtert. Darüber hinaus verfügt IronPDF über einen größeren Funktionsumfang, einschließlich erweiterter PDF-Erstellungsoptionen und Unterstützung für die Arbeit mit HTML, CSS und JavaScript.

Eigenschaften

Eine der Hauptfunktionen von IronPDF ist die Fähigkeit, HTML in PDF mit IronPDF zu konvertieren, wodurch es einfach wird, PDF-Dokumente aus Webseiten zu erstellen. Diese Funktion ist in PDF Sharp nicht verfügbar, was die Einsatzmöglichkeiten einschränkt.

IronPDF unterstützt auch digitale Signaturen und Verschlüsselung, was für sensible Dokumente, die eine sichere Handhabung erfordern, von entscheidender Bedeutung ist. Diese Funktion ist in PDF Sharp nicht verfügbar.

IronPDF ist im Vergleich zu PDF Sharp eine leistungsfähigere und benutzerfreundlichere PDF-Bibliothek mit zusätzlichen Funktionen und besseren Support-Optionen. Allerdings handelt es sich dabei auch um ein kommerzielles Produkt, so dass es für Entwickler, die nach einer kostenlosen oder Open-Source-Lösung suchen, nicht unbedingt die beste Wahl ist.