Migrieren von PDF Duo zu IronPDF in C#

Das PDF-Duo-Risiko-Problem

PDF Duo .NET ist eine schwer zugängliche und weniger bekannte Bibliothek im .NET-Ökosystem. Die Bibliothek mag zwar für Entwickler interessant sein, die Einfachheit suchen, aber ihre Unübersichtlichkeit stellt für Produktionsanwendungen eine große Herausforderung dar:

1. Unklare Herkunft: Unbekannter Entwickler ohne nachweisbare Unternehmenszugehörigkeit. Es gibt kein sichtbares GitHub-Repository oder Quellcode, begrenzte NuGet-Download-Statistiken und unsichere Lizenzbedingungen.

2. Fehlende Dokumentation: Es ist nahezu unmöglich, verlässliche Informationen zu finden. Es gibt keine offizielle API-Referenz, nur wenige Community-Beispiele und keine offiziellen Tutorials oder Anleitungen. Alle Versuche, PDF Duo zu nutzen, werden durch den Mangel an zuverlässiger Dokumentation behindert.

3. Verlassener oder inaktiver Status: Anzeichen von Vernachlässigung sind an sporadischen oder gar keinen Aktualisierungen erkennbar. In den Support-Foren werden Beiträge aus dem Jahr 2019 angezeigt, die nicht beantwortet wurden. Das sehr reale Risiko, dass die Übersetzung aufgegeben wird, beeinträchtigt die Realisierbarkeit für wichtige Projekte.

4. Eingeschränkter Funktionsumfang: Nur Basisfunktionen – einfache HTML-zu-PDF-Konvertierung und einfache PDF-Zusammenführung ohne erweiterte Funktionen wie Formulare, Sicherheit oder Wasserzeichen.

5. Unbekannte Rendering-Engine: Keine Transparenz darüber, was sich im Hintergrund abspielt. Die CSS/JavaScript-Unterstützung ist unbekannt, die Rendering-Qualität ist unvorhersehbar und die Unterstützung moderner Webfunktionen ist ungewiss.

6. Supportrisiko: Keine Entschädigung, wenn etwas kaputt geht. Es gibt keinen professionellen Support, keine Community, die helfen könnte, und es besteht die Gefahr, dass die Übersetzung aufgegeben wird.

Vergleich zwischen PDF Duo und IronPDF

Für Teams, die die Einführung von .NET 10 und C# 14 bis zum Jahr 2025 bzw. 2026 planen, bietetIronPDFeine stabile Grundlage mit aktiver Entwicklung und umfassender Dokumentation, die die Unsicherheiten beseitigt, die mit dem Verlassen auf eine verlassene Bibliothek verbunden sind.

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 PDF Duo .NET(if you can find the correct package name)
dotnet remove package PDFDuo.NET
dotnet remove package PDFDuo
dotnet remove package PDF-Duo

# Install IronPDF
dotnet add package IronPdf

# Remove PDF Duo .NET(if you can find the correct package name)
dotnet remove package PDFDuo.NET
dotnet remove package PDFDuo
dotnet remove package PDF-Duo

# 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 PDF Duo

# Find all PDF Duo references
grep -r "PDFDuo\|HtmlToPdfConverter\|PdfMerger" --include="*.cs" .

# Find all PDF Duo references
grep -r "PDFDuo\|HtmlToPdfConverter\|PdfMerger" --include="*.cs" .

Namensraumänderungen

HTML zu PDF Konvertierung Zuordnungen

Zuordnungen der Seitenkonfiguration

Margins-Zuordnungen

Zuordnungen von Dokumentenoperationen

Neue Funktionen, die in PDF Duo nicht verfügbar sind

Beispiel 1: Konvertierung von HTML in PDF

Vor (PDF Duo):

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        converter.ConvertHtmlString(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        converter.ConvertHtmlString(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<h1>Hello World</h1><p>This is a PDF document.</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully!");
    }
}

Der grundlegende Unterschied ist hier das API-Muster. PDF Duo's HtmlToPdfConverter.ConvertHtmlString() nimmt sowohl den HTML- als auch den Ausgabepfad in einem einzigen Aufruf auf und wickelt Konvertierung und Speicherung gemeinsam ab. IronPDF's ChromePdfRenderer.RenderHtmlAsPdf() gibt zunächst ein PdfDocument Objekt zurück, das Sie dann mit SaveAs() speichern.

Dieser objektorientierte Ansatz bietet erhebliche Vorteile: Sie können die PDF-Datei vor dem Speichern manipulieren (Wasserzeichen hinzufügen, Dokumente zusammenführen, Sicherheit hinzufügen, Text extrahieren) - nichts davon ist mit dem Direct-to-File-Ansatz von PDF Duo möglich. Weitere Rendering-Optionen finden Sie in der HTML to PDF Dokumentation.

Beispiel 2: Konvertierung von URL in PDF

Vor (PDF Duo):

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.ConvertUrl("https://www.example.com", "webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.ConvertUrl("https://www.example.com", "webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("Webpage converted to PDF!");
    }
}

PDF Duo verwendet die gleiche HtmlToPdfConverter-Klasse für die URL-Konvertierung mit ConvertUrl(url, outputPath).IronPDFverwendet ChromePdfRenderer mit der speziellen Methode RenderUrlAsPdf(url), die ein PdfDocument-Objekt zurückgibt.

Ein entscheidender Vorteil ist, dass die Chromium-basierte Rendering-Engine vonIronPDFmoderne CSS3- und JavaScript-Unterstützung bietet, während die unbekannte Rendering-Engine von PDF Duo die CSS/JavaScript-Unterstützung unsicher und die Rendering-Qualität unvorhersehbar macht. Erfahren Sie mehr über die URL in PDF Konvertierung.

Beispiel 3: PDF-Zusammenführung

Vor (PDF Duo):

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        merger.AddFile("document1.pdf");
        merger.AddFile("document2.pdf");
        merger.Merge("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

// NuGet: Install-Package PDFDuo.NET
using PDFDuo;
using System;

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        merger.AddFile("document1.pdf");
        merger.AddFile("document2.pdf");
        merger.Merge("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

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

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("document1.pdf");
        var pdf2 = PdfDocument.FromFile("document2.pdf");
        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully!");
    }
}

Dieses Beispiel zeigt einen grundlegenden architektonischen Unterschied. PDF Duo verwendet eine eigene PdfMerger-Klasse mit einer AddFile()-Methode, um Dateien in eine Warteschlange zu stellen, und dann Merge(), um sie in einem Schritt zu kombinieren und zu speichern.

IronPDF verwendet ein anderes Muster: Jedes PDF-Dokument wird mit PdfDocument.FromFile() als PdfDocument geladen und dann mit der statischen Methode PdfDocument.Merge()zusammengeführt. Dies gibt ein neues PdfDocument-Objekt zurück, das Sie mit SaveAs() separat speichern.

Der IronPDF-Ansatz bietet mehr Flexibilität: Sie können jede der PDF-Dateien vor dem Zusammenführen bearbeiten, Wasserzeichen in das zusammengeführte Ergebnis einfügen, Sicherheitseinstellungen vornehmen und vieles mehr. Um viele Dateien zusammenzuführen, können Sie LINQ verwenden:

var paths = new[] { "document1.pdf", "document2.pdf", "document3.pdf" };
var pdfs = paths.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("merged.pdf");

var paths = new[] { "document1.pdf", "document2.pdf", "document3.pdf" };
var pdfs = paths.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs("merged.pdf");

Erfahren Sie mehr über das Zusammenführen und Aufteilen von PDFs.

Kopf- und Fußzeilen mit Seitenzahlen

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Company Report</div>",
    MaxHeight = 25
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Page {page} of {total-pages}</div>",
    MaxHeight = 25
};

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

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Company Report</div>",
    MaxHeight = 25
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = "<div style='text-align:center; font-size:10px;'>Page {page} of {total-pages}</div>",
    MaxHeight = 25
};

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

PDF Duo unterstützt keine Kopf- oder Fußzeilen - es gibt keine entsprechende Funktionalität.IronPDFbietet vollständige HTML/CSS-Unterstützung mit integrierten Platzhaltern für dynamische Inhalte wie Seitenzahlen. Siehe den Headers and Footers Guide.

Wasserzeichen

using IronPdf;
using IronPdf.Editing;

var pdf = PdfDocument.FromFile("document.pdf");

pdf.ApplyWatermark(
    "<h1 style='color:red; opacity:0.3;'>CONFIDENTIAL</h1>",
    45,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center);

pdf.SaveAs("watermarked.pdf");

using IronPdf;
using IronPdf.Editing;

var pdf = PdfDocument.FromFile("document.pdf");

pdf.ApplyWatermark(
    "<h1 style='color:red; opacity:0.3;'>CONFIDENTIAL</h1>",
    45,
    VerticalAlignment.Middle,
    HorizontalAlignment.Center);

pdf.SaveAs("watermarked.pdf");

PDF Duo unterstützt keine Wasserzeichen.IronPDFbietet HTML-basierte Wasserzeichen mit vollständiger CSS-Styling-Unterstützung.

Passwortschutz

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SaveAs("secured.pdf");

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;
pdf.SaveAs("secured.pdf");

PDF Duo unterstützt keinen Passwortschutz und keine Sicherheitseinstellungen.

Textextraktion

var pdf = PdfDocument.FromFile("document.pdf");
string text = pdf.ExtractAllText();

var pdf = PdfDocument.FromFile("document.pdf");
string text = pdf.ExtractAllText();

PDF Duo unterstützt keine Textextraktion.

Margins Objekt zu einzelnen Eigenschaften

PDF Duo verwendet ein einziges Margins-Objekt;IronPDFverwendet individuelle Eigenschaften:

// PDF Duo:
new Margins(top: 20, right: 15, bottom: 20, left: 15)

// IronPDF:
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginRight = 15;
renderer.RenderingOptions.MarginBottom = 20;
renderer.RenderingOptions.MarginLeft = 15;

// PDF Duo:
new Margins(top: 20, right: 15, bottom: 20, left: 15)

// IronPDF:
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginRight = 15;
renderer.RenderingOptions.MarginBottom = 20;
renderer.RenderingOptions.MarginLeft = 15;

Benennung von Methoden speichern

Verschiedene Methodennamen zum Speichern:

// PDF Duo:
document.Save("output.pdf");

// IronPDF:
pdf.SaveAs("output.pdf");

// PDF Duo:
document.Save("output.pdf");

// IronPDF:
pdf.SaveAs("output.pdf");

Laden von PDFs

Verschiedene Methodennamen für das Laden:

// PDF Duo:
PDFDocument.Load("document.pdf")

// IronPDF:
PdfDocument.FromFile("document.pdf")

// PDF Duo:
PDFDocument.Load("document.pdf")

// IronPDF:
PdfDocument.FromFile("document.pdf")

Einstellungen Objekt zu Eigenschaften

PDF Duo verwendet Einstellungsobjekte, die an den Konstruktor übergeben werden;IronPDFverwendet Eigenschaften:

// PDF Duo:
var settings = new PDFSettings { PageSize = PageSize.A4 };
var converter = new HtmlToPdfConverter(settings);

// IronPDF:
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

// PDF Duo:
var settings = new PDFSettings { PageSize = PageSize.A4 };
var converter = new HtmlToPdfConverter(settings);

// IronPDF:
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

Vor der Migration

• Finde alle PDF Duo-Referenzen im Quellcode
• Dokumentieren Sie die aktuellen Einstellungen (Seitengröße, Ränder usw.).
• Liste aller verwendeten PDF-Operationen
• Möglichkeiten für neue Funktionen identifizieren (Header, Wasserzeichen, Sicherheit)
• IronPDF-Lizenzschlüssel erhalten

Paketänderungen

• Entfernen Sie PDFDuo.NET NuGet-Paket
• Installieren Sie IronPdf NuGet-Paket: dotnet add package IronPdf
• Namespace-Importe von PDFDuo verwenden;auf using IronPdf;

Code-Änderungen

• Lizenzschlüsselkonfiguration beim Start hinzufügen
• Ersetzen Sie HtmlToPdfConverter durch ChromePdfRenderer
• Ersetzen Sie ConvertHtmlString(html, path) durch RenderHtmlAsPdf(html).SaveAs(path)
• Ersetzen Sie ConvertUrl(url, path) durch RenderUrlAsPdf(url).SaveAs(path)
• Ersetzen Sie PdfMerger Muster durch PdfDocument.Merge()-Muster
• Konvertierung Margins Objekts in einzelne Margin-Eigenschaften
• Ersetzen Sie Save() durch SaveAs()
• Ersetzen Sie Load() durch FromFile()

Nach der Migration

• Führen Sie Regressionstests durch, um die PDF-Ausgabe zu vergleichen.
• Überprüfen Sie, ob Seitengrößen und Ränder übereinstimmen.
• Test mit komplexem HTML/CSS (die moderne Engine vonIronPDFsollte damit besser zurechtkommen)
• Neue Funktionen hinzufügen (Kopfzeilen, Fußzeilen, Wasserzeichen, Sicherheit)
• Dokumentation aktualisieren