Wie man von iText zu IronPDF in C# migriert

Die AGPL-Lizenzfalle

iText birgt ernsthafte rechtliche und geschäftliche Risiken für kommerzielle Anwendungen, die viele Entwicklerteams zu spät erkennen:

1. AGPL Viral License: Wenn Sie iText in einer Webanwendung verwenden, verlangt die AGPL, dass Sie Ihre GESAMTE Anwendung als Open Source veröffentlichen – nicht nur den PDF-Code, sondern Ihre gesamte Codebasis. Für die meiste kommerzielle Software ist das kein Grund zur Sorge.

2. Keine unbefristete Lizenz: iText hat die unbefristete Lizenzierung abgeschafft und erzwingt jährliche Abonnementverlängerungen, was die Gesamtbetriebskosten erhöht.

3. Kosten des pdfHTML-Add-ons: Für die HTML-zu-PDF-Funktionalität ist das pdfHTML-Add-on erforderlich, das separat und gegen Aufpreis zur Basislizenz verkauft wird.

4. Komplexe Lizenzprüfungen: Bei Unternehmensimplementierungen kommt es zu komplexen Lizenzierungsfragen und Prüfungsrisiken, die Projekte verzögern und rechtliche Risiken mit sich bringen können.

5. Nur programmatische API: iText erfordert die manuelle Erstellung von PDFs auf niedriger Ebene mit Absatz, Tabelleund ZelleObjekten – mühsam und fehleranfällig bei komplexen Layouts.

6. Eingeschränktes modernes Web-Rendering: Selbst mit pdfHTML erfordert komplexer CSS- und JavaScript-Inhalt einen erheblichen Mehraufwand.

iText vsIronPDFVergleich

Für Teams, die die Einführung von .NET 10 und C# 14 bis 2025 und 2026 planen, bietetIronPDFmit seinem HTML-first-Ansatz eine zukunftssichere Grundlage, die die bereits vorhandenen Webentwicklungskenntnisse Ihres Teams nutzt.

Geschätzter Aufwand nach Merkmalen

Paradigmen-Verschiebung

Der grundlegende Wandel bei dieser iText-Migration besteht in der Umstellung von der programmatischen PDF-Erstellung auf das HTML-First-Rendering:

iText:    PdfWriter → PdfDocument → Dokument → Hinzufügen(Absatz) → Hinzufügen(Tabelle)
IronPDF: ChromePdfRenderer → RenderHtmlAsPdf(htmlString) → SaveAs()

Dieser Paradigmenwechsel ist befreiend: Anstatt das Objektmodell von iText zu lernen, nutzen Sie HTML- und CSS-Kenntnisse, die Webentwickler bereits besitzen.

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 auf ironpdf.com.

NuGet-Paketänderungen

# Remove iText packages
dotnet remove package itext7
dotnet remove package itext7.pdfhtml
dotnet remove package itextsharp

# Install IronPDF
dotnet add package IronPdf

# Remove iText packages
dotnet remove package itext7
dotnet remove package itext7.pdfhtml
dotnet remove package itextsharp

# 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";

Identifizieren Sie die Verwendung von iText

# Find all iText references
grep -r "using iText\|using iTextSharp" --include="*.cs" .
grep -r "PdfWriter\|PdfDocument\|Document\|Paragraph\|Table\|Cell" --include="*.cs" .
grep -r "HtmlConverter\|ConverterProperties" --include="*.cs" .

# Find all iText references
grep -r "using iText\|using iTextSharp" --include="*.cs" .
grep -r "PdfWriter\|PdfDocument\|Document\|Paragraph\|Table\|Cell" --include="*.cs" .
grep -r "HtmlConverter\|ConverterProperties" --include="*.cs" .

Klassen-Zuordnungen

Namespace-Zuordnungen

Beispiel 1: Konvertierung von HTML in PDF

Vor (iText 7):

// NuGet: Install-Package itext7
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";
        string outputPath = "output.pdf";

        using (FileStream fs = new FileStream(outputPath, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, fs);
        }
    }
}

// NuGet: Install-Package itext7
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>";
        string outputPath = "output.pdf";

        using (FileStream fs = new FileStream(outputPath, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, fs);
        }
    }
}

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

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

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

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

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

Der iText-Ansatz erfordert das separate iText.Html2pdf-Paket (pdfHTML-Add-on, separat erhältlich), die Erstellung eines FileStream und die Einbettung in using-Anweisungen zur ordnungsgemäßen Entsorgung. Die Methode HtmlConverter.ConvertToPdf() schreibt direkt in den Stream.

Der Ansatz vonIronPDFist sauberer: Erstellen Sie einen ChromePdfRenderer, rufen Sie RenderHtmlAsPdf() mit Ihrer HTML-Zeichenkette auf, und rufen Sie SaveAs() für das resultierende PdfDocumentauf. Es gibt keine separaten Pakete, keine Stream-Verwaltung, und die Chromium-Rendering-Engine bietet hervorragende CSS3- und JavaScript-Unterstützung. Weitere Rendering-Optionen finden Sie in der HTML to PDF Dokumentation.

Beispiel 2: Mehrere PDFs zusammenführen

Vor (iText 7):

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Kernel.Utils;
using System.IO;

class Program
{
    static void Main()
    {
        string outputPath = "merged.pdf";
        string[] inputFiles = { "document1.pdf", "document2.pdf", "document3.pdf" };

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdfDoc = new PdfDocument(writer))
        {
            PdfMerger merger = new PdfMerger(pdfDoc);

            foreach (string file in inputFiles)
            {
                using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
                {
                    merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
                }
            }
        }
    }
}

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Kernel.Utils;
using System.IO;

class Program
{
    static void Main()
    {
        string outputPath = "merged.pdf";
        string[] inputFiles = { "document1.pdf", "document2.pdf", "document3.pdf" };

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdfDoc = new PdfDocument(writer))
        {
            PdfMerger merger = new PdfMerger(pdfDoc);

            foreach (string file in inputFiles)
            {
                using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
                {
                    merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
                }
            }
        }
    }
}

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdfDocuments = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf"),
            PdfDocument.FromFile("document3.pdf")
        };

        var merged = PdfDocument.Merge(pdfDocuments);
        merged.SaveAs("merged.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdfDocuments = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf"),
            PdfDocument.FromFile("document3.pdf")
        };

        var merged = PdfDocument.Merge(pdfDocuments);
        merged.SaveAs("merged.pdf");
    }
}

Die iText-Merge-Operation erfordert einen erheblichen Aufwand: Erstellen eines PdfWriterfür die Ausgabe, Einpacken in ein PdfDocument, Erstellen eines PdfMerger, dann Iteration durch Quelldateien mit verschachtelten using-Anweisungen für jedes PdfDocumentund PdfReader. Sie müssen auch Seitenbereiche mit merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages()) angeben.

IronPDF reduziert dies auf drei Schritte: Laden der Dokumente mit PdfDocument.FromFile(), Aufruf der statischen Methode PdfDocument.Merge()mit der Liste und Speichern. Der gesamte Merge-Vorgang wird lesbar und wartbar. Erfahren Sie mehr über das Zusammenführen und Aufteilen von PDFs.

Beispiel 3: PDF mit Text und Bildern erstellen

Vor (iText 7):

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    static void Main()
    {
        string outputPath = "document.pdf";

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdf = new PdfDocument(writer))
        using (Document document = new Document(pdf))
        {
            document.Add(new Paragraph("Sample PDF Document"));
            document.Add(new Paragraph("This document contains text and an image."));

            Image img = new Image(ImageDataFactory.Create("image.jpg"));
            img.SetWidth(200);
            document.Add(img);
        }
    }
}

// NuGet: Install-Package itext7
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    static void Main()
    {
        string outputPath = "document.pdf";

        using (PdfWriter writer = new PdfWriter(outputPath))
        using (PdfDocument pdf = new PdfDocument(writer))
        using (Document document = new Document(pdf))
        {
            document.Add(new Paragraph("Sample PDF Document"));
            document.Add(new Paragraph("This document contains text and an image."));

            Image img = new Image(ImageDataFactory.Create("image.jpg"));
            img.SetWidth(200);
            document.Add(img);
        }
    }
}

Nach (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Sample PDF Document</h1>
            <p>This document contains text and an image.</p>
            <img src='image.jpg' width='200' />";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = @"
            <h1>Sample PDF Document</h1>
            <p>This document contains text and an image.</p>
            <img src='image.jpg' width='200' />";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("document.pdf");
    }
}

Dieses Beispiel veranschaulicht den Paradigmenwechsel am deutlichsten. iText benötigt:

• Dreifach verschachtelte benutzen Anweisungen (PdfWriter, PdfDocument, Document)
• Erstellen von Paragraph-Objekten für jedes Textelement mit new Paragraph()
• Verwendung von ImageDataFactory.Create() zum Laden von Bildern
• Erstellen eines Bild-Objekts und separater Aufruf von SetWidth()
• Aufruf von document.Add() für jedes Element

IronPDF verwendet Standard-HTML: <h1> für Überschriften, <p> für Absätze und <img> für Bilder mit einem Breitenattribut. Webentwickler können ihre vorhandenen Kenntnisse sofort nutzen, und Designer können Dokumente mit CSS gestalten, das sie bereits kennen.

Paradigmen-Wechsel: Von Programmatic zu HTML-First

Die wichtigste Änderung bei dieser iText-Migration ist konzeptioneller Natur. iText erstellt PDFs programmatisch:

// iText approach
document.Add(new Paragraph("Title")
    .SetTextAlignment(TextAlignment.CENTER)
    .SetFontSize(24)
    .SetBold());

var table = new Table(UnitValue.CreatePercentArray(3)).UseAllAvailableWidth();
table.AddHeaderCell(new Cell().Add(new Paragraph("ID")));
table.AddHeaderCell(new Cell().Add(new Paragraph("Name")));
// ... many more lines

// iText approach
document.Add(new Paragraph("Title")
    .SetTextAlignment(TextAlignment.CENTER)
    .SetFontSize(24)
    .SetBold());

var table = new Table(UnitValue.CreatePercentArray(3)).UseAllAvailableWidth();
table.AddHeaderCell(new Cell().Add(new Paragraph("ID")));
table.AddHeaderCell(new Cell().Add(new Paragraph("Name")));
// ... many more lines

IronPDF verwendet HTML und CSS:

//IronPDFapproach
string html = @"
    <style>
        h1 { text-align: center; font-size: 24px; font-weight: bold; }
        table { width: 100%; border-collapse: collapse; }
        th { background-color: #4CAF50; color: white; padding: 8px; }
    </style>
    <h1>Title</h1>
    <table>
        <tr><th>ID</th><th>Name</th></tr>
    </table>";

var pdf = renderer.RenderHtmlAsPdf(html);

//IronPDFapproach
string html = @"
    <style>
        h1 { text-align: center; font-size: 24px; font-weight: bold; }
        table { width: 100%; border-collapse: collapse; }
        th { background-color: #4CAF50; color: white; padding: 8px; }
    </style>
    <h1>Title</h1>
    <table>
        <tr><th>ID</th><th>Name</th></tr>
    </table>";

var pdf = renderer.RenderHtmlAsPdf(html);

AGPL-Lizenz abgeschafft

die AGPL-Lizenz von iText erfordert das Open-Sourcing Ihrer gesamten Webanwendung oder den Erwerb einer teuren kommerziellen Lizenz. Die kommerzielle Lizenz vonIronPDFermöglicht den Einsatz in proprietärer Software ohne virale Lizenzierungsanforderungen.

Kein pdfHTML Add-On erforderlich

iText erfordert das separate pdfHTML-Add-on für die HTML-zu-PDF-Konvertierung, das gegen Aufpreis erhältlich ist.IronPDFenthält das vollständige Chromium-basierte HTML-Rendering bereits im Basispaket.

Methoden-Ersetzungsmuster

Ausgabe 1: PdfWriter/Document Pattern

Problem: Der Code verwendet das Verschachtelungsmuster PdfWriter→ PdfDocument→ Dokument.

Lösung: Ersetzen Sie dies durch ChromePdfRenderer:

// Delete this iText pattern:
// using (var writer = new PdfWriter(outputPath))
// using (var pdfDoc = new PdfDocument(writer))
// using (var document = new Document(pdfDoc))

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

// Delete this iText pattern:
// using (var writer = new PdfWriter(outputPath))
// using (var pdfDoc = new PdfDocument(writer))
// using (var document = new Document(pdfDoc))

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

Ausgabe 2: HtmlConverter nicht gefunden

Problem: Der Code verwendet iText.Html2pdf.HtmlConverter , wofür das pdfHTML-Add-on benötigt wird.

Lösung: Verwenden Sie die inIronPDFintegrierte HTML-Rendering-Funktion:

// iText (requires pdfHTML add-on)
HtmlConverter.ConvertToPdf(html, fileStream);

//IronPDF(built-in)
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

// iText (requires pdfHTML add-on)
HtmlConverter.ConvertToPdf(html, fileStream);

//IronPDF(built-in)
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);

Ausgabe 3: Komplexität von PdfMerger

Problem: iText's PdfMergerbenötigt verschachtelte Reader und die Angabe eines Seitenbereichs.

Lösung: Verwenden Sie die statische Merge-Methode von IronPDF:

// iText merger pattern (delete this)
// using (PdfDocument pdfDoc = new PdfDocument(writer))
// {
//     PdfMerger merger = new PdfMerger(pdfDoc);
//     foreach (string file in inputFiles)
//     {
//         using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
//         {
//             merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
//         }
//     }
// }

//IronPDF(simple)
var merged = PdfDocument.Merge(pdfDocuments);
merged.SaveAs("merged.pdf");

// iText merger pattern (delete this)
// using (PdfDocument pdfDoc = new PdfDocument(writer))
// {
//     PdfMerger merger = new PdfMerger(pdfDoc);
//     foreach (string file in inputFiles)
//     {
//         using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
//         {
//             merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
//         }
//     }
// }

//IronPDF(simple)
var merged = PdfDocument.Merge(pdfDocuments);
merged.SaveAs("merged.pdf");

Vor der Migration

• Inventarisierung aller iText-API-Aufrufe im Quellcode
• Programmatische PDF-Konstruktionsmuster identifizieren (Absatz, Tabelle, Zelle)
• Verwendung des Document HtmlConverters (pdfHTML-Add-on)
• AGPL-Compliance-Risiko bewerten
• IronPDF-Lizenzschlüssel erhalten

Code-Migration

• Entfernen Sie die iText NuGet-Pakete: dotnet remove package itext7
• Installieren Sie das IronPdf NuGet-Paket: dotnet add package IronPdf
• Namespace-Importe aktualisieren ( using iText.* → using IronPdf )
• Ersetzen Sie PdfWriter/ Dokumentdurch ChromePdfRenderer
• Absatz/ Tabelle/ Zellein HTML-Elemente umwandeln
• Ersetzen Sie HtmlConverter.ConvertToPdf() durch RenderHtmlAsPdf()
• Aktualisierung der Zusammenführungsoperationen auf PdfDocument.Merge()
• Lizenzschlüsselinitialisierung beim Start hinzufügen

Testen

• Alle PDF-Generierungspfade testen
• Überprüfen Sie, ob die visuelle Ausgabe den Erwartungen entspricht.
• Test mit komplexem HTML/CSS-Inhalt
• Benchmark-Leistung

Nach der Migration

• Entfernen Sie die iText-Lizenzdateien und -Verweise.
• Dokumentation aktualisieren
• iText-Abonnement kündigen (falls zutreffend)
• Archivierung des alten iText-Codes