Nachrichtensymbol
Zum Fußzeileninhalt springen
  1. IronPDF
  2. IronPDF Blog
  3. IronPDF nutzen
  4. HTML in PDF-Dokument C#
IRONPDF NUTZEN

HtmlToPdfDocument C# – Alternative zu DinkToPdf | IronPDF

Curtis Chau
Curtis Chau
Aktualisiert:

Wenn Sie mit HtmlToPdfDocument C# in DinkToPdf arbeiten und auf begrenzte CSS-Unterstützung, externe Abhängigkeiten oder Leistungsprobleme stoßen, sind Sie nicht allein. Viele .NET-Entwickler suchen nach einem HTML-zu-PDF-Konverter, der moderne CSS, Web-Schriftarten und die Ausführung von JavaScript ohne native Bibliothekseinrichtung oder Befehlszeilenwerkzeuge verarbeitet. Diese Anleitung zeigt Ihnen, wie Sie DinkToPdf durch IronPDF ersetzen -- eine .NET-Bibliothek mit einer Chromium-basierten Rendering-Engine, die HTML-Dateien, Webseiten und HTML-Strings in nur wenigen Codezeilen in hochwertige PDFs umwandelt.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<h1>Hello World</h1>")
       .SaveAs("output.pdf");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Wie installieren Sie IronPDF über NuGet?

Bevor Sie jeglichen Konvertierungscode schreiben, müssen Sie IronPDF zu Ihrem Projekt hinzufügen. Der schnellste Weg ist die NuGet-Paketmanager-CLI:

dotnet add package IronPdf
dotnet add package IronPdf
SHELL

Alternativ öffnen Sie die NuGet-Paketmanager-Konsole in Visual Studio und führen aus:

Install-Package IronPdf
Install-Package IronPdf
SHELL

IronPDF richtet sich an .NET 8, .NET 9, .NET 10, .NET Standard 2.0 und .NET Framework 4.6.2 oder höher. Es sind keine zusätzlichen nativen Binärdateien, wkhtmltopdf-Installationen oder die Einrichtung von Befehlszeilenwerkzeugen erforderlich. Das Paket enthält die Chromium-Rendering-Engine und löst alle Abhängigkeiten automatisch. Sobald installiert, können Sie Ihren Lizenzschlüssel im Code oder über eine Umgebungseinstellung definieren und sofort mit der Generierung von PDFs beginnen. Für detaillierte Installationsanleitungen führt die IronPDF Schnellstart-Seite durch jede Umgebung.

Wie schneidet DinkToPdf im Vergleich zu IronPDF ab?

DinkToPdf ist ein .NET Core Wrapper für wkhtmltopdf, der die ältere WebKit-Rendering-Engine nutzt. Obwohl es Open-Source ist, stehen Entwickler oft vor Herausforderungen, wenn sie HTML zu PDF in Produktionsumgebungen konvertieren.

DinkToPdf vs IronPDF Funktionsvergleich
Merkmal DinkToPdf IronPDF
Rendering-Engine WebKit (veraltet) Chromium (modern)
CSS-Unterstützung Eingeschränkte CSS-Unterstützung Volle CSS3, moderne CSS-Unterstützung
JavaScript-Ausführung Begrenzt Volle JavaScript-Rendering
Native Abhängigkeiten Erfordert wkhtmltopdf-Binärdateien Keine externen Abhängigkeiten
Webfonts Teilweise Vollständige Unterstützung
.NET Core / .NET 5+ Ja Ja (.NET Core, Framework, Standard)
Azure App Service Komplexe Einrichtung Läuft out-of-the-box
Threading Singleton erforderlich Thread-sicher
HTML-Vorlagen Grundlegend Erweiterte Funktionen
Ausfüllbare PDF-Formulare Nein Ja

Der Hauptunterschied liegt in der Rendering-Engine. Die WebKit-Engine von DinkToPdf kommt mit komplexen Dokumenten, modernem CSS und dynamischen Webinhalten nicht zurecht. Die Chromium-Engine von IronPDF erzeugt PDF-Dokumente, die genau das wiederspiegeln, was ein Browser rendert. Für eine tiefere Analyse, siehe die IronPDF vs DinkToPdf Vergleichsseite.

Welche Probleme stellt die Klasse HtmlToPdfDocument von DinkToPdf dar?

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 1 - DinkToPdf

Die HtmlToPdfDocument-Klasse in DinkToPdf erfordert eine ausführliche Konfiguration mit Einschränkungen, die sich auf die Qualität der PDF-Konvertierung und die Entwicklererfahrung auswirken:

using DinkToPdf;

var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument()
{
    GlobalSettings = { PaperSize = PaperKind.A4, Out = "output.pdf" },
    Objects = { new ObjectSettings() { HtmlContent = "<h1>Hello</h1>" } }
};
converter.Convert(doc);
using DinkToPdf;

var converter = new SynchronizedConverter(new PdfTools());
var doc = new HtmlToPdfDocument()
{
    GlobalSettings = { PaperSize = PaperKind.A4, Out = "output.pdf" },
    Objects = { new ObjectSettings() { HtmlContent = "<h1>Hello</h1>" } }
};
converter.Convert(doc);
$vbLabelText   $csharpLabel

DinkToPdf PDF-Ausgabe

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 2 - DinkToPdf-Beispielausgabe PDF

Häufige Probleme umfassen: langsame PDF-Generierung selbst für einfache Aufgaben, Threading-Komplikationen auf Webservern und Schwierigkeiten beim Umgang mit Webinhalten mit JavaScript. Das wkhtmltopdf-Befehlszeilenwerkzeug schafft Bereitstellungsprobleme für Azure App Service und serverlose Umgebungen, in denen keine System-Ebene-Binärdateien installiert werden können. Entwickler berichten auch, dass das Singleton-Konverter-Muster bei gleichzeitiger Auslastung zum Engpass wird.

Abgesehen von der Leistung zeigt das DinkToPdf-Projekt auf GitHub begrenzte Wartungsaktivitäten, was bedeutet, dass Fehler bei der CSS-Rendering oder SSL-Behandlung selten behoben werden. Für Produktionsanwendungen, die täglich Tausende von PDFs verarbeiten, sind diese Lücken nicht akzeptabel. Wenn ein CSS-Grid-Layout fehlschlägt oder eine Web-Schriftart nicht geladen werden kann, benötigen Sie eine Bibliothek, die dem modernen Browserverhalten folgt, nicht eine, die mit einer Rendering-Engine aus den frühen 2010er Jahren eingefroren ist.

Wie konvertiert man einen HTML-String zu PDF mit IronPDF?

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 3 - IronPDF

IronPDF vereinfacht die HTML zu PDF-Konvertierung mit einer sauberen API und überragender Ausgabequalität. Die ChromePdfRenderer verarbeitet alle HTML-Inhalte -- von einem einfachen HTML-String bis zu komplexen HTML-Seiten mit externen Stylesheets, Google-Schriftarten und JavaScript-gesteuerten Layouts.

using IronPdf;

var renderer = new ChromePdfRenderer();

string htmlContent = @"
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-size: 14px; text-align: center; }
            h1 { color: #2563eb; }
        </style>
    </head>
    <body>
        <h1>Professional Invoice</h1>
        <p>Generated with modern CSS support</p>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

string htmlContent = @"
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-size: 14px; text-align: center; }
            h1 { color: #2563eb; }
        </style>
    </head>
    <body>
        <h1>Professional Invoice</h1>
        <p>Generated with modern CSS support</p>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("invoice.pdf");
$vbLabelText   $csharpLabel

IronPDF HTML-String-Ausgabe

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 4 - IronPDF-Beispiel einfacher HTML-String zu PDF-Ausgabe

Dieser Code zeigt, wie IronPDF HTML und CSS während der Konvertierung verarbeitet und PDF-Dokumente mit korrekter Schriftgrößenwiedergabe und Textausrichtung erzeugt -- alles ohne externe Abhängigkeiten. Die RenderHtmlAsPdf-Methode akzeptiert jeden gültigen HTML5-String, einschließlich Inline-Stile, eingebettete Skripte und Daten-URIs für Bilder.

Wie konvertiert man eine HTML-Datei zu PDF?

Zur Konvertierung von auf der Festplatte gespeicherten HTML-Dateien:

using IronPdf;

var renderer = new ChromePdfRenderer();
var doc = renderer.RenderHtmlFileAsPdf("templates/input.html");
doc.SaveAs("example.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
var doc = renderer.RenderHtmlFileAsPdf("templates/input.html");
doc.SaveAs("example.pdf");
$vbLabelText   $csharpLabel

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 5 - Ausgabe für HTML-Datei zu PDF-Beispiel

Die RenderHtmlFileAsPdf-Methode löst relative Pfade für Bilder, Stylesheets und Skripte relativ zum Speicherort der HTML-Datei auf der Festplatte, sodass bestehende Vorlagen ohne Anpassung funktionieren. Dies macht die Migration bestehender Berichtsvorlagen einfach.

Wie konvertiert man eine Webseiten-URL in PDF?

Die Konvertierung von Live-Web-Inhalten ist eine Stärke von IronPDF im Vergleich zur eingeschränkten JavaScript-Rendering von DinkToPdf. Die Chromium-Engine von IronPDF unterstützt dynamische HTML-Elemente, Single-Page-Anwendungen und interaktive Formulare.

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

string url = "https://en.wikipedia.org/wiki/Main_Page";
var page = renderer.RenderUrlAsPdf(url);
page.SaveAs("webpage.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(500);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

string url = "https://en.wikipedia.org/wiki/Main_Page";
var page = renderer.RenderUrlAsPdf(url);
page.SaveAs("webpage.pdf");
$vbLabelText   $csharpLabel

Konvertierte URL in PDF

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 6 - Gerendertes PDF aus URL-Inhalt

Dieser Ansatz ist ideal zum Erstellen von Rechnungen aus Webformularen oder zum Archivieren von Live-Dashboards. Die Rendering-Engine verarbeitet alle Web-Schriftarten, CSS-Stile und JavaScript, bevor sie die PDF-Datei erzeugt. Die WaitFor-API bietet präzise Kontrolle darüber, wann die Chromium-Engine eine Seite als bereit zur Erfassung ansieht -- Sie können auf bestimmte DOM-Elemente, Netzwerkträgheit oder benutzerdefinierte JavaScript-Bedingungen warten, was für die großflächige PDF-Erzeugung aus dynamischen Inhalten unerlässlich ist.

Für authentifizierte Seiten können Sie HTTP-Header, Cookies oder formale POST-Daten direkt an den Renderer übergeben. Die URL zu PDF-Dokumentation beschreibt diese fortgeschrittenen Szenarien im Detail.

Wie konfigurieren Sie die PDF-Ausgabeeinstellungen?

Beide Bibliotheken bieten Konfigurationsoptionen, aber IronPDF bietet mehr intuitive Kontrolle über das erzeugte PDF durch sein RenderingOptions-Objekt:

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.TextHeader.CenterText = "Company Report";
renderer.RenderingOptions.TextFooter.CenterText = "{page} of {total-pages}";

var document = renderer.RenderHtmlAsPdf("<h1 style='text-align: center;'>Quarterly Report</h1>");
document.SaveAs("configured-report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.TextHeader.CenterText = "Company Report";
renderer.RenderingOptions.TextFooter.CenterText = "{page} of {total-pages}";

var document = renderer.RenderHtmlAsPdf("<h1 style='text-align: center;'>Quarterly Report</h1>");
document.SaveAs("configured-report.pdf");
$vbLabelText   $csharpLabel

Ausgabe-PDF mit benutzerdefinierten Einstellungen

HtmlToPdfDocument C#: DinkToPdf-Alternative zur HTML zu PDF-Konvertierung: Bild 7 - Anpassbare PDF-Ausgabe

Diese Optionen steuern Papiergröße, Ränder, Kopf- und Fußzeilen. IronPDF unterstützt auch benutzerdefinierte HTML-Kopf- und Fußzeilen, die vollwertiges HTML und CSS akzeptieren und Logos, dynamische Seitenzahlen und gestalteten Text in den Kopf- und Fußzeilenbereichen platzieren lassen. Für die Dokumentensicherheit ermöglicht die PDF-Verschlüsselungs- und Passwort-API, das Drucken, Kopieren oder Bearbeiten nach der Erzeugung einzuschränken.

Wie kombiniert man mehrere PDFs?

Wenn Sie mehrere HTML-Dokumente zu einem PDF zusammenfassen müssen, bietet IronPDF eine statische Merge-Methode:

using IronPdf;

var renderer = new ChromePdfRenderer();

var pdf1 = renderer.RenderHtmlAsPdf("<h1>Section One</h1>");
var pdf2 = renderer.RenderHtmlAsPdf("<h1>Section Two</h1>");

var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged-report.pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

var pdf1 = renderer.RenderHtmlAsPdf("<h1>Section One</h1>");
var pdf2 = renderer.RenderHtmlAsPdf("<h1>Section Two</h1>");

var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged-report.pdf");
$vbLabelText   $csharpLabel

Die PDF-Merge-Dokumentation zeigt, wie man große Dokumente aus vielen Quelldateien zusammenstellt, konsistente Kopf- und Fußzeilen auf alle Abschnitte anwendet und Seiten programmatisch neu ordnet. Das ist nützlich für Berichterstellungspipelines, die einzelne Abschnitte unabhängig vor dem Kombinieren in ein einziges Enddokument erstellen.

Warum sollten Sie von DinkToPdf zu IronPDF wechseln?

Für Entwickler, die HtmlToPdfDocument in .NET Core-Anwendungen verwenden, bietet IronPDF entscheidende Vorteile, die jedes Problem direkt ansprechen:

  • Moderne Rendererstellung: Die Chromium-Engine verarbeitet die HTML-Struktur, moderne CSS und die Ausführung von JavaScript für pixelgenaue PDF-Dokumente
  • Null Einrichtung: Keine wkhtmltopdf-Binärdateien oder Befehlszeilenwerkzeug-Konfiguration -- einfach das NuGet-Paket hinzufügen
  • Bessere Leistung: Schnellere PDF-Konvertierung ohne Singleton-Threading-Beschränkungen; der Renderer ist Thread-sicher und kann gleichzeitige Konvertierungen durchführen
  • Umfassende Web-Unterstützung: HTML mit Web-Schriftarten, CSS-Animationen, SVG-Grafiken und komplexen HTML-Vorlagen konvertieren
  • Enterprise-Bereitstellung: Bereitstellung auf Azure App Service, AWS Lambda, Docker-Container und traditionellen Webservern ohne zusätzliche Konfiguration
  • Erweiterte PDF-Funktionen: Ausfüllbare PDF-Formulare, digitale Signaturen, PDF/A-Konformität und Wasserzeichen
  • Aktive Wartung: IronPDF veröffentlicht regelmäßige Updates, die die neuesten Chromium-Versionen und .NET-Laufzeiten verfolgen

Laut dem Release-Zeitplan des Chromium-Projekts erhält die Engine alle vier Wochen Sicherheitsupdates. IronPDF liefert aktualisierte Chromium-Builds mit jeder Hauptversion, um sicherzustellen, dass Ihre PDF-Generierung ohne manuelle Binärverwaltung aktuell bleibt. Das ist wichtig für sicherheitsbewusste Teams, die nachweisen müssen, dass ihre Abhängigkeiten gegen bekannte Schwachstellen gepatcht sind.

Die IronPDF-Dokumentationsbibliothek umfasst mehr als 50 Anleitungen für Aufgaben, die von Aufteilen von PDFs bis hin zur Extraktion von Text und Bildern und Hinzufügung von Anmerkungen reichen.

Was sind Ihre nächsten Schritte?

Während DinkToPdf's HtmlToPdfDocument-Klasse grundlegende HTML-zu-PDF-Konvertierung bietet, schaffen seine veraltete WebKit-Engine und externen Abhängigkeiten Reibungen für moderne .NET-Entwicklung. IronPDF liefert bessere Ergebnisse mit Chromium-basierter Wiedergabe, voller CSS-Unterstützung und Zero-Dependency-Bereitstellung. Egal, ob Sie ein kleines internes Berichterstellungstool oder einen hochvolumigen Dokumentenerstellungsservice erstellen, der Migrationspfad ist einfach: Installieren Sie das NuGet-Paket, ersetzen Sie die DinkToPdf-API-Aufrufe durch ChromePdfRenderer-Äquivalente und entfernen Sie die wkhtmltopdf-Binärdateien aus Ihrer Bereitstellungspipeline.

Um voranzukommen, wählen Sie den Weg, der Ihrer Situation entspricht:

Starten Sie jetzt mit IronPDF.
green arrow pointer

Häufig gestellte Fragen

Was ist IronPDF?

IronPDF ist eine .NET-Bibliothek zur Konvertierung von HTML in PDF mit einer Chromium-Rendering-Engine. Es unterstützt moderne CSS, JavaScript-Ausführung und Web-Schriftarten und erfordert keine nativen Abhängigkeiten oder externen Binärdateien.

Warum sollte ich IronPDF gegenüber DinkToPdf bevorzugen?

IronPDF bietet vollständigen CSS3-Support, keine nativen Bibliotheken oder wkhtmltopdf-Einrichtung, threadsichere gleichzeitige Konvertierungen und eine einfache Bereitstellung auf Azure App Service und Docker -- adressiert alle Hauptprobleme von DinkToPdf.

Wie verbessert IronPDF die Leistung bei der Konvertierung von HTML in PDF?

IronPDF verwendet eine Chromium-Rendering-Engine, die HTML, CSS und JavaScript effizient verarbeitet. Sein threadsicheres Design eliminiert den Singleton-Engpass, der DinkToPdf bei gleichzeitiger Last beeinträchtigt.

Unterstützt IronPDF moderne Web-Schriftarten?

Ja. Die Chromium-Engine von IronPDF unterstützt vollständig Google Fonts, Systemschriftarten und benutzerdefinierte Web-Schriftarten, die in HTML eingebettet sind, und erzeugt eine genaue Schriftartdarstellung im ausgegebenen PDF.

Kann IronPDF während der PDF-Konvertierung JavaScript ausführen?

Ja. Setzen Sie EnableJavaScript auf true in RenderingOptions und verwenden Sie die WaitFor-API, um zu steuern, wann Chromium die Seite als bereit betrachtet, um sicherzustellen, dass dynamische Inhalte vollständig gerendert sind, bevor sie erfasst werden.

Welche Abhängigkeiten sind für die Verwendung von IronPDF erforderlich?

IronPDF erfordert keine nativen Abhängigkeiten. Installieren Sie es über NuGet und das Paket verwaltet die Chromium-Engine intern. Keine wkhtmltopdf-Binärdateien oder Befehlszeilenwerkzeuge sind erforderlich.

Ist in IronPDF eine vollständige CSS-Unterstützung verfügbar?

Ja. IronPDF unterstützt CSS3, Flexbox, CSS Grid, benutzerdefinierte Eigenschaften und Medienabfragen, was eine genaue Wiedergabe komplexer HTML-Dokumente ermöglicht.

Wie geht IronPDF mit externen Bibliotheken oder Tools um?

IronPDF verlässt sich nicht auf externe Bibliotheken oder Befehlszeilenwerkzeuge. Alles ist im NuGet-Paket gebündelt, was die Bereitstellung vereinfacht und Kompatibilitätsprobleme eliminiert.

Welche Rendering-Engine nutzt IronPDF?

IronPDF verwendet eine Chromium-basierte Rendering-Engine, dieselbe Engine, die Google Chrome antreibt, und bietet präzise und leistungsstarke HTML-zu-PDF-Konvertierungen.

Ist IronPDF for .NET-Entwickler geeignet, die nach einer Lösung für die Umwandlung von HTML in PDF suchen?

Ja. IronPDF zielt auf .NET 8, .NET 9, .NET 10, .NET Standard 2.0 und .NET Framework 4.6.2 oder höher ab und eignet sich gleichermaßen für moderne und ältere .NET-Anwendungen.

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

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me