Wie man XML in PDF mit C# konvertiert

PdfPigverstehen

PdfPig (NuGet-Paket PdfPig, Namespace UglyToad.PdfPig) ist eine Open-Source .NET-Bibliothek zum Lesen und Extrahieren von PDFs, ursprünglich inspiriert und teilweise portiert vom Apache PDFBox-Java-Projekt. Es ermöglicht Entwicklern, auf den strukturellen Inhalt von PDFs mit hoher Präzision zuzugreifen. Während PdfPigim Bereich der Extraktion glänzt, ist sein Umfang enger als der von kommerziellen Vollzyklus-Bibliotheken. Das Projekt bleibt vor Version 1.0 (aktuelle stabile Version ist 0.1.14), und die README-Datei weist darauf hin, dass "solange die Version unter 1.0.0 ist, sich die öffentliche API ohne Vorwarnung ändern wird."

PdfPig bietet zuverlässige Werkzeuge zum Extrahieren von Text (mit Buchstaben- und Wortebenenpositionen), Bildern, schreibgeschützten Formulardaten, Anmerkungen und Metadaten. Es bietet auch eine begrenzte Schreibfunktionalität — PdfDocumentBuilder für die Erstellung neuer Dokumente auf niedriger Ebene und PdfMerger (in UglyToad.PdfPig.Writer) für das Zusammenfügen bestehender PDFs. Das macht es zu einer geeigneten Wahl für Anwendungen, die sich hauptsächlich auf Dokumentenanalyse, Datenmining und grundlegende Zusammenführungen konzentrieren.

Die Lesezentrierte Begrenzung

PdfPig ist lesen-zuerst; seine Schreibfläche ist absichtlich eng. Wenn Ihre Anwendung mehr als Extraktion und grundlegendes Zusammenführen benötigt, kann PdfPignicht helfen:

1. Begrenzte PDF-Erstellung: Neue Dokumente erfordern eine manuelle PdfPoint-Koordinatenplatzierung über PdfDocumentBuilder — keine hochgradige Layoutfunktion.

2. Kein HTML-zu-PDF: PdfPigist eine Bibliothek zum Lesen und Parsen von PDFs, keine Bibliothek zur PDF-Generierung. Für die Konvertierung von HTML in PDF müssten Sie eine andere Bibliothek verwenden.

3. Begrenzte Dokumentmanipulation: PdfMerger deckt das Zusammenfügen ab, aber es gibt keine API für das Trennen/Drehen/Bearbeiten auf hohem Niveau.

4. Keine Sicherheitserstellung: Kann verschlüsselte PDFs (mit Passwort) lesen, aber keine Passwörter, Verschlüsselung oder digitale Signaturen hinzufügen.

5. Keine Wasserzeichen/Stempel: Keine hochrangige API für visuelle Overlays auf bestehenden Dokumenten.

6. Keine Formularbefüllung: Formulare sind schreibgeschützt — Werte können nicht geändert oder hinzugefügt werden.

PdfPigvs IronPDF Vergleich

IronPDF unterstützt einen kompletten Satz von Funktionen zum Erstellen, Lesen, Bearbeiten und Signieren von PDFs. Diese Vielseitigkeit ermöglicht es Entwicklern, PDF-Dateien von Anfang bis Ende auf modernem .NET zu verwalten und eine vollständige PDF-Lifecycle-Lösung zu bieten, die über die Lesemöglichkeiten von PdfPighinausgeht.

Voraussetzungen

1. .NET -Umgebung: .NET Framework 4.6.2+ oder .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGet -Zugriff: Möglichkeit zur Installation von NuGet -Paketen
3. IronPDF -Lizenz: Ihren Lizenzschlüssel erhalten Sie unter IronPDF.

NuGet-Paketänderungen

# Remove PdfPig
dotnet remove package PdfPig

# Install IronPDF
dotnet add package IronPdf

# Remove PdfPig
dotnet remove package PdfPig

# Install IronPDF
dotnet add package IronPdf

Lizenz-Konfiguration

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

PdfPig-Verwendung identifizieren

# Find PdfPigusage
grep -r "UglyToad\.PdfPig\|PdfDocument\.Open\|GetPages\(\)" --include="*.cs" .

# Find page index references (may need 1→0 conversion)
grep -r "GetPage(\|NumberOfPages" --include="*.cs" .

# Find PdfPigusage
grep -r "UglyToad\.PdfPig\|PdfDocument\.Open\|GetPages\(\)" --include="*.cs" .

# Find page index references (may need 1→0 conversion)
grep -r "GetPage(\|NumberOfPages" --include="*.cs" .

Namensraumänderungen

// Before: PdfPig
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
using UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

// Before: PdfPig
using UglyToad.PdfPig;
using UglyToad.PdfPig.Content;
using UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

' Before: PdfPig
Imports UglyToad.PdfPig
Imports UglyToad.PdfPig.Content
Imports UglyToad.PdfPig.DocumentLayoutAnalysis.WordExtractor

' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering

Zuordnungen beim Laden von Dokumenten

Seitenzugriff und Eigenschaftszuordnungen

Textextraktions-Zuordnungen

Metadaten-Zugriffs-Zuordnungen

Neue Funktionen, die in PdfPignicht verfügbar sind

Hinweis: PDF-Zusammenführung ist in beiden Bibliotheken verfügbar (PdfMerger in PdfPig, PdfDocument.Merge in IronPDF).

Beispiel 1: Textextraktion aus PDF

Vor (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var text = new StringBuilder();
            foreach (var page in document.GetPages())
            {
                text.AppendLine(page.Text);
            }
            Console.WriteLine(text.ToString());
        }
    }
}

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var text = new StringBuilder();
            foreach (var page in document.GetPages())
            {
                text.AppendLine(page.Text);
            }
            Console.WriteLine(text.ToString());
        }
    }
}

Imports UglyToad.PdfPig
Imports System
Imports System.Text

Class Program
    Shared Sub Main()
        Using document = PdfDocument.Open("input.pdf")
            Dim text = New StringBuilder()
            For Each page In document.GetPages()
                text.AppendLine(page.Text)
            Next
            Console.WriteLine(text.ToString())
        End Using
    End Sub
End Class

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();
        Console.WriteLine(text);
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();
        Console.WriteLine(text);
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim pdf = PdfDocument.FromFile("input.pdf")
        Dim text As String = pdf.ExtractAllText()
        Console.WriteLine(text)
    End Sub
End Class

Sowohl PdfPigals auch IronPDF bieten hervorragende Textextraktionsfunktionen. Der Hauptunterschied liegt im Codemuster. PdfPigerfordert eine using-Anweisung mit PdfDocument.Open(), eine manuelle Iteration durch die Seiten mit GetPages() und einen StringBuilder, um Text von jeder page.Text-Eigenschaft zu sammeln.

IronPDF vereinfacht dies auf einen einzigen Aufruf: PdfDocument.FromFile() lädt das Dokument, und ExtractAllText() gibt alle Textinhalte auf einmal zurück. Keine using-Anweisung erforderlich, keine manuelle Iteration, kein StringBuilder. Weitere Optionen finden Sie in der Textextraktionsdokumentation.

Beispiel 2: Konvertierung von HTML in PDF

Vor (PdfPig):

PdfPig unterstützt keine HTML-zu-PDF-Konvertierung. PdfPigist eine Bibliothek zum Lesen und Parsen von PDFs, keine Bibliothek zur PDF-Erstellung. Für die Konvertierung von HTML in PDF benötigen Sie eine andere Bibliothek.

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML</p>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Dieses Beispiel verdeutlicht die größte Kompetenzlücke. PdfPigweist ausdrücklich darauf hin, dass es "keine Konvertierung von HTML in PDF unterstützt" und "eine Bibliothek zum Lesen/Parsen von PDFs ist, keine Bibliothek zur PDF-Erzeugung" Wenn Sie mit PdfPigPDFs aus HTML erstellen wollen, müssen Sie eine ganz andere Bibliothek verwenden.

IronPDF bietet native HTML-zu-PDF-Konvertierung durch ChromePdfRenderer. Die RenderHtmlAsPdf()-Methode akzeptiert HTML-Zeichenfolgen und konvertiert sie in PDF-Dokumente, indem intern eine Chromium-Engine für eine genaue Darstellung von HTML, CSS und JavaScript verwendet wird. Das resultierende PdfDocument kann mit SaveAs() gespeichert oder vor dem Speichern weiter bearbeitet werden. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.

Beispiel 3: Lesen von PDF-Metadaten

Vor (PdfPig):

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var info = document.Information;
            Console.WriteLine($"Title: {info.Title}");
            Console.WriteLine($"Author: {info.Author}");
            Console.WriteLine($"Subject: {info.Subject}");
            Console.WriteLine($"Creator: {info.Creator}");
            Console.WriteLine($"Producer: {info.Producer}");
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}");
        }
    }
}

// NuGet: Install-Package PdfPig
using UglyToad.PdfPig;
using System;

class Program
{
    static void Main()
    {
        using (var document = PdfDocument.Open("input.pdf"))
        {
            var info = document.Information;
            Console.WriteLine($"Title: {info.Title}");
            Console.WriteLine($"Author: {info.Author}");
            Console.WriteLine($"Subject: {info.Subject}");
            Console.WriteLine($"Creator: {info.Creator}");
            Console.WriteLine($"Producer: {info.Producer}");
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}");
        }
    }
}

Imports UglyToad.PdfPig
Imports System

Class Program
    Shared Sub Main()
        Using document = PdfDocument.Open("input.pdf")
            Dim info = document.Information
            Console.WriteLine($"Title: {info.Title}")
            Console.WriteLine($"Author: {info.Author}")
            Console.WriteLine($"Subject: {info.Subject}")
            Console.WriteLine($"Creator: {info.Creator}")
            Console.WriteLine($"Producer: {info.Producer}")
            Console.WriteLine($"Number of Pages: {document.NumberOfPages}")
        End Using
    End Sub
End Class

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        var info = pdf.MetaData;
        Console.WriteLine($"Title: {info.Title}");
        Console.WriteLine($"Author: {info.Author}");
        Console.WriteLine($"Subject: {info.Subject}");
        Console.WriteLine($"Creator: {info.Creator}");
        Console.WriteLine($"Producer: {info.Producer}");
        Console.WriteLine($"Number of Pages: {pdf.PageCount}");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        var info = pdf.MetaData;
        Console.WriteLine($"Title: {info.Title}");
        Console.WriteLine($"Author: {info.Author}");
        Console.WriteLine($"Subject: {info.Subject}");
        Console.WriteLine($"Creator: {info.Creator}");
        Console.WriteLine($"Producer: {info.Producer}");
        Console.WriteLine($"Number of Pages: {pdf.PageCount}");
    }
}

Imports IronPdf
Imports System

Class Program
    Shared Sub Main()
        Dim pdf = PdfDocument.FromFile("input.pdf")
        Dim info = pdf.MetaData
        Console.WriteLine($"Title: {info.Title}")
        Console.WriteLine($"Author: {info.Author}")
        Console.WriteLine($"Subject: {info.Subject}")
        Console.WriteLine($"Creator: {info.Creator}")
        Console.WriteLine($"Producer: {info.Producer}")
        Console.WriteLine($"Number of Pages: {pdf.PageCount}")
    End Sub
End Class

Beide Bibliotheken bieten Zugriff auf Metadaten mit nahezu identischen Mustern. PdfPiggreift auf Metadaten über document.Information und auf die Seitenanzahl über document.NumberOfPages zu.IronPDF verwendet pdf.MetaData für Metadaten und pdf.PageCount für die Seitenanzahl.

Die Migration ist einfach: Ersetzen Sie PdfDocument.Open() durch PdfDocument.FromFile(), document.Information durch pdf.MetaData und document.NumberOfPages durch pdf.PageCount. Entfernen Sie die using-Anweisungshülle, da IronPDF sie nicht benötigt.

Änderung der Seitenindizierung

PdfPig verwendet eine 1-basierte Indizierung;IronPDF verwendet 0-basierte:

// PdfPig: 1-basiertindexing
var firstPage = document.GetPage(1);  // First page

// IronPDF: 0-basiertindexing
var firstPage = pdf.Pages[0];  // First page

// Migration helper
int pdfPigIndex = 1;
int ironPdfIndex = pdfPigIndex - 1;

// PdfPig: 1-basiertindexing
var firstPage = document.GetPage(1);  // First page

// IronPDF: 0-basiertindexing
var firstPage = pdf.Pages[0];  // First page

// Migration helper
int pdfPigIndex = 1;
int ironPdfIndex = pdfPigIndex - 1;

' PdfPig: 1-based indexing
Dim firstPage = document.GetPage(1)  ' First page

' IronPDF: 0-based indexing
Dim firstPage = pdf.Pages(0)  ' First page

' Migration helper
Dim pdfPigIndex As Integer = 1
Dim ironPdfIndex As Integer = pdfPigIndex - 1

Nutzungserklärung nicht erforderlich

// PdfPig: Requires using for disposal
using (var document = PdfDocument.Open("input.pdf"))
{
    // ...
}

// IronPDF: No using required (but can use for cleanup)
var pdf = PdfDocument.FromFile("input.pdf");
// ...
// pdf.Dispose(); // Optional

// PdfPig: Requires using for disposal
using (var document = PdfDocument.Open("input.pdf"))
{
    // ...
}

// IronPDF: No using required (but can use for cleanup)
var pdf = PdfDocument.FromFile("input.pdf");
// ...
// pdf.Dispose(); // Optional

Imports PdfPig
Imports IronPDF

Using document = PdfDocument.Open("input.pdf")
    ' ...
End Using

Dim pdf = PdfDocument.FromFile("input.pdf")
' ...
' pdf.Dispose() ' Optional

Änderung beim Laden des Dokuments

// PdfPig: PdfDocument.Open()
using (var document = PdfDocument.Open("input.pdf"))

// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("input.pdf");

// PdfPig: PdfDocument.Open()
using (var document = PdfDocument.Open("input.pdf"))

// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("input.pdf");

Imports PdfPig
Imports IronPDF

Using document = PdfDocument.Open("input.pdf")
End Using

Dim pdf = PdfDocument.FromFile("input.pdf")

Änderung des Namens der Metadaten-Eigenschaft

// PdfPig: document.Information
var info = document.Information;

// IronPDF: pdf.MetaData
var info = pdf.MetaData;

// PdfPig: document.Information
var info = document.Information;

// IronPDF: pdf.MetaData
var info = pdf.MetaData;

' PdfPig: document.Information
Dim info = document.Information

' IronPDF: pdf.MetaData
Dim info = pdf.MetaData

Eigenschaftsänderung der Seitenzahl

// PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}");

// IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}");

// PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}");

// IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}");

' PdfPig: document.NumberOfPages
Console.WriteLine($"Pages: {document.NumberOfPages}")

' IronPDF: pdf.PageCount
Console.WriteLine($"Pages: {pdf.PageCount}")

PDF-Zusammenführung

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")

Wasserzeichen

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")

Passwortschutz

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword"
pdf.SecuritySettings.OwnerPassword = "ownerpassword"

Digitale Signaturen

var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningReason = "Document Approval"
};
pdf.Sign(signature);

var signature = new PdfSignature("certificate.pfx", "password")
{
    SigningContact = "support@company.com",
    SigningReason = "Document Approval"
};
pdf.Sign(signature);

Dim signature As New PdfSignature("certificate.pfx", "password") With {
    .SigningContact = "support@company.com",
    .SigningReason = "Document Approval"
}
pdf.Sign(signature)

Vor der Migration

• Erfassung aller PdfPig-Nutzungen im Quellcode
• Prüfen Sie, ob Sie Positionsdaten auf Wortebene benötigen (erwägen Sie einen hybriden Ansatz).
• Alle Seitenindexverweise beachten (müssen von 1-basiert in 0-basiert umgerechnet werden)
• Speicherung des IronPDF-Lizenzschlüssels (Umgebungsvariablen empfohlen)
• Zuerst mit der IronPDF Testlizenz testen

Paketänderungen

• Entfernen Sie das NuGet-Paket PdfPig: dotnet remove package PdfPig
• Installieren Sie das NuGet-Paket IronPdf: dotnet add package IronPdf

Code-Änderungen

• Aktualisieren Sie die Namespace-Importe (using UglyToad.PdfPig; → using IronPdf;)
• Ersetzen Sie PdfDocument.Open() durch PdfDocument.FromFile()
• Ersetzen Sie document.Information durch pdf.MetaData
• Ersetzen Sie document.NumberOfPages durch pdf.PageCount
• Seitenindizes von 1-basiert auf 0-basiert konvertieren
• Entfernen Sie using-Anweisungen (optional,IronPDF erfordert sie nicht)
• Fügen Sie den IronPDF Lizenzschlüssel beim Anwendungsstart hinzu.

Nach der Migration

• Die Ausgabe der Testtextextraktion entspricht den Erwartungen
• Alle PDF-Generierungsszenarien testen
• Fügen Sie bei Bedarf neue Funktionen hinzu (Zusammenführung, Wasserzeichen, Sicherheit).
• Installieren Sie die Linux-Abhängigkeiten, wenn Sie unter Linux bereitstellen.