iTextSharp für C# (.NET): Komplettguide mit Beispielen

Einführung in iTextSharp: Was ist das und wofür braucht man es?

iTextSharp ist eine leistungsstarke Bibliothek zur Erstellung und Bearbeitung von PDF-Dokumenten auf der .NET-Plattform (C#, VB.NET, F#). Sie ist ein Port der bekannten Java-Bibliothek iText und gibt Entwicklern die volle Kontrolle über das Erstellen, Ändern und Lesen von PDF-Dateien.

Die wichtigsten Funktionen von iTextSharp:

• PDF-Dokumente von Grund auf neu erstellen
• Text, Bilder, Tabellen und Listen hinzufügen
• Schriftarten verwalten (inkl. Unicode und Sonderzeichen)
• Hyperlinks, Lesezeichen und Metadaten einfügen
• Verschlüsselung und Passwortschutz
• PDF-Dateien zusammenführen und aufteilen
• Wasserzeichen und Kopf-/Fußzeilen hinzufügen
• Formulare bearbeiten (AcroForms)

Die Bibliothek wird häufig in Unternehmensanwendungen eingesetzt, um Berichte, Rechnungen, Lieferscheine, Zertifikate und andere Dokumente zu generieren. iTextSharp unterstützt .NET Framework 2.0+ und .NET Core (über iTextSharp.LGPLv2.Core).

Installation von iTextSharp

Zur Installation von iTextSharp in ein .NET-Projekt wird der NuGet Package Manager verwendet. Es gibt mehrere Versionen der Bibliothek:

• iTextSharp (alte Version 5.x, LGPL) – kostenlos, aber mit Einschränkungen
• iTextSharp.LGPLv2.Core – Fork für .NET Core / .NET 5+
• iText7 (iText.LGPLv2.Core) – neue Version iText 7 für .NET

Installation über die Package Manager Console:

Install-Package iTextSharp.LGPLv2.Core -Version 1.7.0

Installation über die .NET CLI:

dotnet add package iTextSharp.LGPLv2.Core --version 1.7.0

Installation über die Visual Studio NuGet-Oberfläche:

1. Rechtsklick auf das Projekt → "NuGet-Pakete verwalten"
2. Suche: "iTextSharp.LGPLv2.Core"
3. Version auswählen und auf "Installieren" klicken

Wichtig: Für die Arbeit mit Unicode und Sonderzeichen ist eine zusätzliche Konfiguration erforderlich (siehe Abschnitt "Tipps").

Schnellstart: Das erste PDF-Dokument erstellen

Hier ein minimales Beispiel zum Erstellen einer PDF-Datei mit dem Text "Hallo, Welt!":

using System.IO;
using iTextSharp.text;
using iTextSharp.text.pdf;

class Program
{
    static void Main()
    {
        // Dokument erstellen
        Document doc = new Document();
        
        // Dateistream zum Schreiben erstellen
        using (FileStream fs = new FileStream("HalloWelt.pdf", FileMode.Create))
        {
            // PdfWriter-Instanz holen
            PdfWriter writer = PdfWriter.GetInstance(doc, fs);
            
            // Dokument öffnen
            doc.Open();
            
            // Absatz mit Text hinzufügen
            doc.Add(new Paragraph("Hallo, Welt!"));
            
            // Dokument schließen
            doc.Close();
        }
        
        Console.WriteLine("PDF erfolgreich erstellt!");
    }
}

Dieser Code erstellt die Datei HalloWelt.pdf im Ausführungsverzeichnis. Beachten Sie die Reihenfolge: Document erstellen → öffnen → Inhalt hinzufügen → schließen.

Wichtige Methoden und Funktionen von iTextSharp

Hier sind 10 zentrale Methoden/Klassen der Bibliothek mit detaillierten Beschreibungen und Beispielen.

1. Document (Klasse)

Funktion: Repräsentiert das PDF-Dokument selbst. Verwaltet Seiten, Ränder und Ausrichtung.

Konstruktor-Parameter:

• Rectangle pageSize – Seitengröße (z. B. PageSize.A4)
• float marginLeft, marginRight, marginTop, marginBottom – Seitenränder

Beispiel:

// A4-Dokument im Querformat mit benutzerdefinierten Rändern
Document doc = new Document(PageSize.A4.Rotate(), 50, 50, 30, 30);
doc.Open();
doc.Add(new Paragraph("Querformat"));
doc