Nachrichtensymbol
Zum Fußzeileninhalt springen
  1. IronPDF
  2. IronPDF Blog
  3. Migrationsleitfäden
  4. migration von DynamicPDF zu IronPDF
MIGRATIONSLEITFäDEN

Migrieren von DynamicPDF zu IronPDF in C#

Curtis Chau
Curtis Chau
Veröffentlicht:

Warum von DynamicPDFzuIronPDFmigrieren?

Die Produktfragmentierung von DynamicPDFist der Hauptgrund für die Migration. Das Verständnis des Lizenzierungsmodells ist wichtig, um die tatsächlichen Kosten Ihrer aktuellen Implementierung zu ermitteln.

Das Problem der Produktfragmentierung

DynamicPDF wird als separate Produkte mit separaten Lizenzen verkauft:

  1. DynamicPDF Generator: PDFs von Grund auf neu erstellen
  2. DynamicPDF Merger: Vorhandene PDFs zusammenführen, aufteilen und bearbeiten (separater Kauf)
  3. DynamicPDF Core Suite: Kombinierter Generator und Zusammenführer
  4. DynamicPDF ReportWriter: Berichtserstellung
  5. DynamicPDF HTML Converter: HTML-zu-PDF-Konvertierung (separates Add-on)
  6. DynamicPDF Print Manager: PDFs programmgesteuert drucken

Eine vollständige PDF-Lösung erfordert 3-5 separate Lizenzen mit DynamicPDF.IronPDFenthält alles in einem Paket.

Architektur-Vergleich

Aspekt DynamicPDF IronPDF
Produktmodell Fragmentiert (5+ Produkte) All-in-One-Bibliothek
Lizenzierung Mehrere Lizenzen erforderlich Einzellizenz
HTML zu PDF Separater Kauf eines Add-ons Eingebaut, Chromium-basiert
CSS-Unterstützung Eingeschränkt (erfordert Add-on) Vollständiges CSS3 mit Flexbox/Grid
API-Stil Koordinatenbasierte Positionierung HTML/CSS + Manipulation API
Lernkurve Steep (mehrere APIs) Sanft (Webtechnologien)
Modernes .NET .NET Standard 2.0 .NET 6/7/8/9+ nativ

Wichtige Vorteile der Migration

  1. Einzelpaket: Ein NuGet-Paket ersetzt 3-5 DynamicPDF-Pakete
  2. Modernes Rendering: Chromium-Engine versus älteres Rendering
  3. Webtechnologien: Verwenden Sie HTML/CSS anstelle von koordinatenbasierter Positionierung.
  4. Einfachere API: Weniger Code, bessere Lesbarkeit, leichtere Wartung
  5. Keine Zusatzkäufe: HTML, Zusammenführung, Sicherheit – alles inklusive

Vorbereitung auf die Migration

Voraussetzungen

Stellen Sie sicher, dass Ihre Umgebung diese Anforderungen erfüllt:

  • .NET Framework 4.6.2+ oder .NET Core 3.1 / .NET 5-9
  • Visual Studio 2019+ oder VS Code mit C#-Erweiterung
  • NuGet Package Manager Zugang
  • IronPDF-Lizenzschlüssel (kostenlose Testversion erhältlich unter ironpdf.com)

Nutzung von DynamicPDFprüfen

Führen Sie diese Befehle in Ihrem Lösungsverzeichnis aus, um alle DynamicPDF-Referenzen zu identifizieren:

# Find all DynamicPDFreferences
grep -r "ceTe.DynamicPDF\|DynamicPDF" --include="*.cs" --include="*.csproj" .

# Check NuGet packages
dotnet list package | grep -i dynamic
# Find all DynamicPDFreferences
grep -r "ceTe.DynamicPDF\|DynamicPDF" --include="*.cs" --include="*.csproj" .

# Check NuGet packages
dotnet list package | grep -i dynamic
SHELL

Übliche Pakete, nach denen Sie suchen sollten:

  • ceTe.DynamicPDF.CoreSuite.NET
  • ceTe.DynamicPDF.Generator.NET
  • ceTe.DynamicPDF.Merger.NET
  • ceTe.DynamicPDF.HtmlConverter.NET

Verständnis des Paradigmenwechsels

Die wichtigste Änderung bei der Migration von DynamicPDFzuIronPDFist der grundlegende Ansatz zur Dokumentenerstellung. DynamicPDFverwendet eine koordinatenbasierte Positionierung, bei der Sie Elemente an bestimmten X,Y-Koordinaten auf einer Seite platzieren.IronPDFverwendet HTML/CSS-Rendering, bei dem Sie mit Webtechnologien entwerfen.

Dieser Paradigmenwechsel bedeutet, dass Label-, TextArea- und Table2-Elemente in ihre HTML-Entsprechungen umgewandelt werden müssen - eine Änderung, die in der Regel zu besser lesbarem, wartbarem Code führt.

Schritt-für-Schritt-Migrationsprozess

Schritt 1: NuGet-Pakete aktualisieren

Entfernen Sie alle DynamicPDF-Pakete und installieren Sie IronPDF:

# Remove DynamicPDFpackages
dotnet remove package ceTe.DynamicPDF.CoreSuite.NET
dotnet remove package ceTe.DynamicPDF.Generator.NET
dotnet remove package ceTe.DynamicPDF.Merger.NET
dotnet remove package ceTe.DynamicPDF.HtmlConverter.NET

# Install IronPDF
dotnet add package IronPdf
# Remove DynamicPDFpackages
dotnet remove package ceTe.DynamicPDF.CoreSuite.NET
dotnet remove package ceTe.DynamicPDF.Generator.NET
dotnet remove package ceTe.DynamicPDF.Merger.NET
dotnet remove package ceTe.DynamicPDF.HtmlConverter.NET

# Install IronPDF
dotnet add package IronPdf
SHELL

Schritt 2: Namensraumreferenzen aktualisieren

Ersetzen Sie die DynamicPDF-Namensräume durch IronPDF:

// Remove these
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;
using ceTe.DynamicPDF.Merger;
using ceTe.DynamicPDF.Conversion;

// Add this
using IronPdf;
// Remove these
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;
using ceTe.DynamicPDF.Merger;
using ceTe.DynamicPDF.Conversion;

// Add this
using IronPdf;
$vbLabelText   $csharpLabel

Schritt 3: Lizenz konfigurieren

// 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";
$vbLabelText   $csharpLabel

Komplette API-Migrationsreferenz

Kernklassen-Zuordnung

DynamicPDF-Klasse IronPDF-Äquivalent Notizen
Dokument ChromePdfRenderer Für die Erstellung neuer PDFs
Dokument PdfDocument Für die Bearbeitung vorhandener PDFs
Seite HTML <div> mit Seitenumbruch Oder mehrere Renderings
MergeDocument PdfDocument.Merge() Statische Merge-Methode
HtmlKonverter ChromePdfRenderer Eingebaut, kein Add-on

Seitenelemente zu HTML-Zuordnung

DynamicPDFPageElement IronPDF/HTML-Äquivalent
Label <p>, <span>, <div>
TextBereich <div>, <p> mit CSS
Bild <img> tag
Tabelle2 HTML <table>
SeitennummerierungLabel {Seite} / {Gesamtseiten} Platzhalter

Schlüssel-API-Zuordnungen

DynamicPDF IronPDF Notizen
Dokument + Seite ChromePdfRenderer HTML-basierte Erstellung
Label, TextArea HTML <p>, <div> Stil mit CSS
Tabelle2 HTML <table> Vollständiges CSS-Styling
MergeDocument PdfDocument.Merge() Statische Methode
HtmlKonverter ChromePdfRenderer Eingebaut, kein Add-on
document.Draw() pdf.SaveAs() / pdf.BinaryData
SeitennummerierungLabel %%CP%% {Seite} Platzhalter Unterschiedliche Syntax

Beispiele für die Code-Migration

HTML-zu-PDF-Konvertierung

Die HTML-zu-PDF-Konvertierung zeigt, dass DynamicPDFein separates HtmlConverter-Add-on benötigt, währendIronPDFdas integrierte Chromium-Rendering nutzt.

DynamicPDF-Einführung:

// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.Conversion;

class Program
{
    static void Main()
    {
        string html = "<html><body><h1>Hello World</h1></body></html>";
        HtmlConverter converter = new HtmlConverter(html);
        converter.Convert("output.pdf");
    }
}
// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.Conversion;

class Program
{
    static void Main()
    {
        string html = "<html><body><h1>Hello World</h1></body></html>";
        HtmlConverter converter = new HtmlConverter(html);
        converter.Convert("output.pdf");
    }
}
$vbLabelText   $csharpLabel

IronPDF-Implementierung:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        string html = "<html><body><h1>Hello World</h1></body></html>";
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

Der ChromePdfRenderervonIronPDFbietet Chromium-basiertes Rendering mit vollständiger CSS3-Unterstützung - der Kauf eines separaten Add-ons ist nicht erforderlich. Weitere Optionen finden Sie in der HTML zu PDF Dokumentation.

Mehrere PDFs zusammenführen

Das Zusammenführen von PDF-Dateien demonstriert den Unterschied zwischen der Klasse MergeDocumentvon DynamicPDF(für die eine Merger-Produktlizenz erforderlich ist) und der integrierten statischen Methode Merge von IronPDF.

DynamicPDF-Einführung:

// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.Merger;

class Program
{
    static void Main()
    {
        MergeDocument document = new MergeDocument("document1.pdf");
        document.Append("document2.pdf");
        document.Draw("merged.pdf");
    }
}
// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.Merger;

class Program
{
    static void Main()
    {
        MergeDocument document = new MergeDocument("document1.pdf");
        document.Append("document2.pdf");
        document.Draw("merged.pdf");
    }
}
$vbLabelText   $csharpLabel

IronPDF-Implementierung:

// NuGet: Install-Package IronPdf
using IronPdf;

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");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;

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");
    }
}
$vbLabelText   $csharpLabel

Die statische Methode Merge vonIronPDFakzeptiert direkt mehrere PdfDocument-Objekte. Weitere Optionen finden Sie in der Dokumentation zum Zusammenführen von PDFs .

Text in PDFs einfügen

Die Textplatzierung demonstriert den Paradigmenwechsel von den koordinatenbasierten Label-Elementen von DynamicPDFzum HTML-basierten TextStamper von IronPDF.

DynamicPDF-Einführung:

// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Page page = new Page(PageSize.Letter);
        Label label = new Label("Hello from DynamicPDF!", 0, 0, 504, 100);
        page.Elements.Add(label);
        document.Pages.Add(page);
        document.Draw("output.pdf");
    }
}
// NuGet: Install-Package ceTe.DynamicPDF.CoreSuite.NET
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;

class Program
{
    static void Main()
    {
        Document document = new Document();
        Page page = new Page(PageSize.Letter);
        Label label = new Label("Hello from DynamicPDF!", 0, 0, 504, 100);
        page.Elements.Add(label);
        document.Pages.Add(page);
        document.Draw("output.pdf");
    }
}
$vbLabelText   $csharpLabel

IronPDF-Implementierung:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<html><body></body></html>");
        var textStamper = new TextStamper()
        {
            Text = "Hello from IronPDF!",
            FontSize = 20,
            VerticalAlignment = VerticalAlignment.Top
        };
        pdf.ApplyStamp(textStamper);
        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<html><body></body></html>");
        var textStamper = new TextStamper()
        {
            Text = "Hello from IronPDF!",
            FontSize = 20,
            VerticalAlignment = VerticalAlignment.Top
        };
        pdf.ApplyStamp(textStamper);
        pdf.SaveAs("output.pdf");
    }
}
$vbLabelText   $csharpLabel

IronPDFs TextStamper bietet eine ausrichtungsbasierte Positionierung anstelle einer koordinatenbasierten Platzierung, wodurch Layouts besser an unterschiedliche Seitengrößen angepasst werden können. Weitere Optionen finden Sie in der Dokumentation zu Wasserzeichen und Stempelungen.

Beispiel für eine vollständige Dokumentenerstellung

Dieses umfassende Beispiel zeigt die Konvertierung eines DynamicPDF-Dokuments mit mehreren Elementen in den HTML-Ansatz von IronPDF.

DynamicPDF-Einführung:

using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;
using ceTe.DynamicPDF.Merger;

// Generation (requires Generator license)
Document document = new Document();
Page page = new Page(PageSize.A4);
Label title = new Label("Invoice Report", 0, 0, 595, 30, Font.HelveticaBold, 18);
title.Align = TextAlign.Center;
page.Elements.Add(title);

Table2 table = new Table2(40, 60, 515, 500);
// ... complex table setup with columns, rows, cells...
page.Elements.Add(table);
document.Pages.Add(page);
document.Draw("invoice.pdf");

// Merging (requires Merger license)
MergeDocument mergeDoc = new MergeDocument("cover.pdf");
mergeDoc.Append("invoice.pdf");
mergeDoc.Draw("final.pdf");
using ceTe.DynamicPDF;
using ceTe.DynamicPDF.PageElements;
using ceTe.DynamicPDF.Merger;

// Generation (requires Generator license)
Document document = new Document();
Page page = new Page(PageSize.A4);
Label title = new Label("Invoice Report", 0, 0, 595, 30, Font.HelveticaBold, 18);
title.Align = TextAlign.Center;
page.Elements.Add(title);

Table2 table = new Table2(40, 60, 515, 500);
// ... complex table setup with columns, rows, cells...
page.Elements.Add(table);
document.Pages.Add(page);
document.Draw("invoice.pdf");

// Merging (requires Merger license)
MergeDocument mergeDoc = new MergeDocument("cover.pdf");
mergeDoc.Append("invoice.pdf");
mergeDoc.Draw("final.pdf");
$vbLabelText   $csharpLabel

IronPDF-Implementierung:

using IronPdf;

var renderer = new ChromePdfRenderer();

// All features in one library
var html = @"
<html>
<head>
    <style>
        body { font-family: Helvetica, sans-serif; padding: 40px; }
        h1 { text-align: center; font-size: 18pt; }
        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        th, td { border: 1px solid #ccc; padding: 8px; }
    </style>
</head>
<body>
    <h1>Invoice Report</h1>
    <table>
        <tr><th>Product</th><th>Qty</th><th>Price</th></tr>
        <tr><td>Widget</td><td>10</td><td>$99.99</td></tr>
    </table>
</body>
</html>";

var invoice = renderer.RenderHtmlAsPdf(html);

// Merging included - no separate license
var cover = PdfDocument.FromFile("cover.pdf");
var final = PdfDocument.Merge(cover, invoice);
final.SaveAs("final.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// All features in one library
var html = @"
<html>
<head>
    <style>
        body { font-family: Helvetica, sans-serif; padding: 40px; }
        h1 { text-align: center; font-size: 18pt; }
        table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        th, td { border: 1px solid #ccc; padding: 8px; }
    </style>
</head>
<body>
    <h1>Invoice Report</h1>
    <table>
        <tr><th>Product</th><th>Qty</th><th>Price</th></tr>
        <tr><td>Widget</td><td>10</td><td>$99.99</td></tr>
    </table>
</body>
</html>";

var invoice = renderer.RenderHtmlAsPdf(html);

// Merging included - no separate license
var cover = PdfDocument.FromFile("cover.pdf");
var final = PdfDocument.Merge(cover, invoice);
final.SaveAs("final.pdf");
$vbLabelText   $csharpLabel

Kritische Hinweise zur Migration

Koordinatenbasiert zu HTML/CSS-Positionierung

Der grundlegende Paradigmenwechsel erfordert die Konvertierung der X,Y-Koordinatenpositionierung in CSS-basierte Layouts:

// DynamicPDF- coordinate-based
var label = new Label("Hello World", 100, 200, 300, 50);

//IronPDF- CSS positioning (if absolute positioning needed)
var html = "<div style='position:absolute; left:100px; top:200px; width:300px;'>Hello World</div>";

//IronPDF- preferred approach (flow-based)
var html = "<div style='margin-left:100px; margin-top:200px;'>Hello World</div>";
// DynamicPDF- coordinate-based
var label = new Label("Hello World", 100, 200, 300, 50);

//IronPDF- CSS positioning (if absolute positioning needed)
var html = "<div style='position:absolute; left:100px; top:200px; width:300px;'>Hello World</div>";

//IronPDF- preferred approach (flow-based)
var html = "<div style='margin-left:100px; margin-top:200px;'>Hello World</div>";
$vbLabelText   $csharpLabel

Syntax der Seitennummerierung

DynamicPDF undIronPDFverwenden eine andere Platzhalter-Syntax für Seitenzahlen:

// DynamicPDFplaceholders
"Page %%CP%% of %%TP%%"

//IronPDFplaceholders
"Page {page} of {total-pages}"
// DynamicPDFplaceholders
"Page %%CP%% of %%TP%%"

//IronPDFplaceholders
"Page {page} of {total-pages}"
$vbLabelText   $csharpLabel

Kopf- und Fußzeilen

Konvertieren Sie DynamicPDFTemplate-Elemente inIronPDFHtmlHeaderFooter:

//IronPDFheader/footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 25
};
//IronPDFheader/footer
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align:center;'>Page {page} of {total-pages}</div>",
    MaxHeight = 25
};
$vbLabelText   $csharpLabel

Weitere Optionen für Kopf- und Fußzeilen finden Sie in der Kopf- und Fußzeilen-Dokumentation.

Sicherheitseinstellungen

//IronPDFsecurity
pdf.SecuritySettings.OwnerPassword = "ownerPassword";
pdf.SecuritySettings.UserPassword = "userPassword";
//IronPDFsecurity
pdf.SecuritySettings.OwnerPassword = "ownerPassword";
pdf.SecuritySettings.UserPassword = "userPassword";
$vbLabelText   $csharpLabel

Ausführliche Informationen zu den Sicherheitsoptionen finden Sie in der Dokumentation zur Verschlüsselung .

Post-Migrations-Checkliste

Überprüfen Sie nach Abschluss der Codemigration Folgendes:

  • Visueller Vergleich der generierten PDFs
  • Überprüfen Sie die Textpositionierung und das Layout.
  • Testen der Tabellendarstellung und des Überlaufs
  • Überprüfen Sie die Kopf- und Fußzeilen auf allen Seiten
  • Test der Formularausfüllfunktion
  • Sicherheit/Verschlüsselung überprüfen
  • Leistungsvergleich
  • Nicht verwendete DynamicPDF-Lizenzdateien entfernen
  • Dokumentation aktualisieren

Zukunftssicherheit für Ihre PDF-Infrastruktur

Mit .NET 10 am Horizont und C# 14, das neue Sprachfunktionen einführt, gewährleistet die Wahl einer PDF-Bibliothek, die moderne .NET-Muster berücksichtigt, langfristige Kompatibilität. Die native Unterstützung vonIronPDFfür .NET 6/7/8/9+ bietet einen klaren Weg nach vorne, wenn Projekte bis ins Jahr 2025 und 2026 reichen - ohne die Komplexität der Verwaltung mehrerer Produktlizenzen oder der Navigation durch fragmentierte APIs.

Zusätzliche Ressourcen

Durch die Migration von DynamicPDFzuIronPDFentfällt die Komplexität der Verwaltung mehrerer Produktlizenzen, während gleichzeitig ein modernes Chromium-basiertes Rendering und volle CSS3-Unterstützung geboten werden. Der Übergang von koordinatenbasierter Positionierung zu HTML/CSS-Design führt in der Regel zu besser wartbarem Code, der vertraute Webtechnologien nutzt.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen

Verwandte Artikel

30-Tage-Testversion → Volles Produkt. Keine Grenzen. Keine Karte. Gratis testen