1. IronPDF
  2. Anleitungen
  3. Wie man eine HTML-Datei in PDF rendert
Wie man eine HTML-Datei in PDF in C# rendert

HTML-Datei in C# mit IronPDF in PDF umwandeln

Curtis Chau
Curtis Chau
Aktualisiert:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF konvertiert HTML-Dateien in C# in PDF-Dokumente, indem es sie durch eine Chrome-basierte Engine rendert. Ein einziger Methodenaufruf genügt, um jede zugängliche HTML-Datei in eine professionelle PDF-Ausgabe zu verwandeln.

IronPDF rendert jede HTML-Datei, auf die der Rechner Zugriff hat, und ist damit eine unkomplizierte Lösung für die PDF-Erzeugung.

Schnellstart: HTML-Datei mit IronPDF in PDF konvertieren

Konvertieren Sie HTML-Dateien mit IronPDF in nur wenigen Zeilen Code in PDF. Die Klasse ChromePdfRenderer wandelt HTML-Inhalte schnell in PDF-Dokumente um. Geben Sie den Pfad zu Ihrer HTML-Datei an, und IronPDF kümmert sich um die Konvertierung. Dieser rationalisierte Prozess ist ideal für das Hinzufügen von PDF-Generierungsfunktionen zu C#-Anwendungen.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer()
  .RenderHtmlFileAsPdf("path/to/your/file.html")
  .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

Minimaler Arbeitsablauf (5 Schritte)

IronPDF tutorial showing 5 steps to convert HTML to PDF in C# with NuGet installation command
  1. Herunterladen der IronPDF-Bibliothek für die Umwandlung von HTML in PDF
  2. Instantiate the `ChromePdfRenderer` class
  3. Configure the `RenderingOptions` to fine-tune the output PDF
  4. Übergeben Sie den Pfad der HTML-Datei an den Renderer.
  5. PDF speichern und herunterladen

Wie konvertiere ich HTML-Dateien mit IronPDF in PDF?

IronPDF rendert HTML-Dateien mithilfe der RenderHtmlFileAsPdf Methode in PDFs. Der Parameter ist ein Dateipfad zu einer lokalen HTML-Datei.

Diese Methode ermöglicht es Entwicklern, HTML-Inhalte während der Entwicklung in einem Browser zu testen. Sie können die Wiedergabetreue vor der Konvertierung überprüfen. Chrome wird empfohlen, da die Rendering-Engine von IronPDF auf diesem Betriebssystem basiert.

Wenn der Inhalt in Chrome korrekt angezeigt wird, wird er auch in IronPDF korrekt wiedergegeben. Genaue Rendering-Anforderungen finden Sie in unserem Leitfaden zum Debuggen von HTML mit Chrome, um sicherzustellen, dass Ihre PDFs Ihren Erwartungen entsprechen.

Welche HTML-Inhalte kann ich konvertieren?

Dies ist die example.html HTML-Datei, die vom Code gerendert wird:


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>


<!DOCTYPE html>
<html>
    <head>
        <title>Page Title</title>
    </head>

    <body>
        <h1>My First Heading</h1>
        <p>My first paragraph.</p>
    </body>
</html>
HTML

Die im Web gerenderte HTML-Datei wird unten angezeigt.

IronPDF unterstützt erweiterte HTML-Funktionen wie CSS3, JavaScript, Bilder und Schriftarten. Erfahren Sie mehr über Rendering-Optionen, mit denen Sie Ihre PDF-Ausgabe mit Kopf- und Fußzeilen, Rändern und vielem mehr anpassen können.

Wie implementiere ich die Konvertierung in C#?

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf.cs
using IronPdf;
using IronPdf.Engines.Chrome;
using IronPdf.Rendering;


var renderer = new ChromePdfRenderer
{
    RenderingOptions = new ChromePdfRenderOptions
    {
        CssMediaType = PdfCssMediaType.Print,
        MarginBottom = 0,
        MarginLeft = 0,
        MarginRight = 0,
        MarginTop = 0,
        Timeout = 120,
    },
};
renderer.RenderingOptions.WaitFor.RenderDelay(50);

// Create a PDF from an existing HTML file using C#
var pdf = renderer.RenderHtmlFileAsPdf("example.html");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf
Imports IronPdf.Engines.Chrome
Imports IronPdf.Rendering


Private renderer = New ChromePdfRenderer With {
	.RenderingOptions = New ChromePdfRenderOptions With {
		.CssMediaType = PdfCssMediaType.Print,
		.MarginBottom = 0,
		.MarginLeft = 0,
		.MarginRight = 0,
		.MarginTop = 0,
		.Timeout = 120
	}
}
renderer.RenderingOptions.WaitFor.RenderDelay(50)

' Create a PDF from an existing HTML file using C#
Dim pdf = renderer.RenderHtmlFileAsPdf("example.html")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

Die Methode RenderHtmlFileAsPdf gibt ein PdfDocument-Objekt zurück, das PDF-Informationen enthält. Sie können dieses Objekt weiter bearbeiten - zum Beispiel können Sie Kopf- und Fußzeilen hinzufügen, Wasserzeichen anbringen oder mehrere PDFs zusammenführen zu einem einzigen Dokument.

Die Rendering-Optionen passen die Ausgabe an. Durch die Einstellung von CssMediaType auf Print werden druckspezifische CSS-Regeln angewendet, während Randeinstellungen ein randloses Dokument erzeugen. Die Zeitspanne von 120 Sekunden ermöglicht es, komplexe HTML-Dateien mit externen Ressourcen vollständig zu laden.

Die 50 Millisekunden RenderDelay stellen sicher, dass alle Ressourcen geladen werden, bevor die PDF-Datei erstellt wird. Dies hilft bei JavaScript-lastigen Seiten. Für komplexe Szenarien mit dynamischen Inhalten lesen Sie unseren Leitfaden zum JavaScript-Rendering.

Wie sieht die endgültige PDF-Ausgabe aus?

Dies ist die PDF-Datei, die der Code erzeugt hat:

Wie kann ich die Standard-Druckeinstellungen von Chrome verwenden?

Um die Standarddruckoptionen von Chrome zu verwenden, greifen Sie auf die DefaultChrome-Eigenschaft der Klasse ChromePdfRenderOptions zu und weisen Sie sie RenderingOptions zu. Mit dieser Einstellung entspricht die Ausgabe von IronPDF genau der Chrome-Druckvorschau.

:path=/static-assets/pdf/content-code-examples/how-to/html-file-to-pdf-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome;
Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Configure the rendering options to default Chrome options
renderer.RenderingOptions = ChromePdfRenderOptions.DefaultChrome
$vbLabelText   $csharpLabel

Die Standardeinstellungen von Chrome eignen sich gut, wenn Sie möchten, dass die PDFs dem entsprechen, was die Benutzer beim Drucken von ihrem Browser aus sehen. Bei diesem Ansatz werden gängige Druckeinstellungen wie Seitenumbrüche, Kopf- und Fußzeilenformatierung und Standardränder automatisch berücksichtigt.

Zusätzliche Konvertierungsoptionen

IronPDF bietet mehrere verwandte Funktionen, die die Arbeitsabläufe bei der PDF-Erstellung verbessern:

  • Konvertieren von HTML-Strings: Generieren Sie HTML dynamisch und konvertieren Sie HTML-Strings direkt in PDF, ohne sie vorher in einer Datei zu speichern.
  • URL zu PDF: Konvertieren Sie Live-Webseiten mit unserem Leitfaden zum Konvertieren von URLs in PDF.
  • HTML-ZIP-Archive: Für komplexe Projekte mit mehreren Ressourcen lernen Sie, wie Sie HTML-ZIP-Dateien in PDF konvertieren.
  • Benutzerdefinierte Silbentrennung : ChromePdfRenderOptions unterstützt die Silbentrennung über die Eigenschaft HyphenationLanguage. Setzen Sie es in Ihrem CSS zusammen mit hyphens: auto auf eine bestimmte Sprache, um den automatischen Wortumbruch im generierten PDF zu aktivieren. Für fortgeschrittene Anwendungsfälle akzeptiert die Eigenschaft CustomHyphenation benutzerdefinierte Silbentrennungsmuster, die Vorrang vor der sprachbasierten Option haben.

Erwägungen zur Leistung

Bei der Konvertierung von HTML-Dateien in PDF in Produktionsumgebungen sollten Sie diese Optimierungen berücksichtigen:

  1. Async Operations: Verwenden Sie asynchrone PDF-Erzeugung-Methoden für eine bessere Reaktionsfähigkeit der Anwendung.
  2. Zwischenspeichern: Zwischenspeichern von PDF-Ergebnissen, wenn dieselbe HTML-Datei mehrmals konvertiert wird, um wiederholtes Rendern zu vermeiden.
  3. Ressourcenverwaltung : PdfDocument-Objekte sollten nach Gebrauch immer freigegeben werden, um Speicherplatz freizugeben.
  4. Stapelverarbeitung : Um eine bessere Leistung zu erzielen, kann dieselbe ChromePdfRenderer-Instanz beim Konvertieren mehrerer Dateien wiederverwendet werden.

Behebung häufiger Probleme

Wenn Sie bei der Konvertierung von HTML in PDF auf Probleme stoßen, können Sie diese Lösungen ausprobieren:

  • Fehlende Ressourcen: Stellen Sie sicher, dass alle CSS-, JavaScript- und Bilddateien, auf die in Ihrem HTML-Text verwiesen wird, vom Speicherort der Datei aus zugänglich sind.
  • Schriftwiedergabe: Für eine konsistente Darstellung von Schriften auf verschiedenen Systemen können Sie Schriften in Ihr HTML einbetten oder unseren Leitfaden zur Schriftenverwaltung lesen.
  • Große Dateien: Bei HTML-Dateien mit vielen Bildern oder komplexen Layouts sollten Sie PDF-Komprimierungstechniken verwenden, um die Dateigröße zu verringern.

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier an: PDFs konvertieren

Häufig gestellte Fragen

Welche Rendering-Engine wird bei der Konvertierung von HTML in PDF verwendet?

IronPDF verwendet eine Chrome-basierte Rendering-Engine, um HTML-Dateien in PDF zu konvertieren. Dadurch wird sichergestellt, dass Ihre HTML-Inhalte in der PDF-Datei genau so wiedergegeben werden, wie sie im Chrome-Browser angezeigt werden.

Wie konvertiere ich in C# eine HTML-Datei in PDF?

Verwenden Sie die ChromePdfRenderer-Klasse von IronPDF mit der Methode RenderHtmlFileAsPdf. Übergeben Sie einfach den Pfad Ihrer HTML-Datei als Parameter und speichern Sie die Ausgabe mit der SaveAs-Methode. Die gesamte Konvertierung erfordert nur ein paar Zeilen Code.

Welche HTML-Funktionen werden bei der PDF-Konvertierung unterstützt?

IronPDF unterstützt erweiterte HTML-Funktionen wie CSS3, JavaScript, Bilder und Schriftarten. Die Chrome-basierte Engine gewährleistet während des Konvertierungsprozesses volle Kompatibilität mit modernen Webstandards.

Kann ich die PDF-Ausgabe mit Kopf- und Fußzeilen anpassen?

Ja, IronPDF ermöglicht eine umfassende Anpassung der PDF-Ausgabe. Sie können Kopf- und Fußzeilen hinzufügen, Wasserzeichen anwenden, Ränder festlegen und mehrere PDFs zusammenführen. Die RenderingOptions-Konfiguration bietet eine fein abgestimmte Kontrolle über das endgültige Dokument.

Wie kann ich sicherstellen, dass mein HTML-Text vor der Konvertierung in PDF korrekt wiedergegeben wird?

Testen Sie Ihre HTML-Inhalte vor der Konvertierung im Chrome-Browser. Da IronPDF eine Chrome-basierte Rendering-Engine verwendet, werden Inhalte, die in Chrome korrekt angezeigt werden, auch in der PDF-Datei korrekt wiedergegeben. Wenn Sie genaue Anforderungen haben, verwenden Sie den Debugging-Leitfaden von IronPDF für pixelgenaues Rendering.

Welchen Objekttyp gibt die Konvertierungsmethode zurück?

Die Methode RenderHtmlFileAsPdf gibt ein PdfDocument-Objekt zurück. Dieses Objekt enthält alle PDF-Informationen und kann für zusätzliche Operationen wie das Hinzufügen von Wasserzeichen oder das Zusammenführen mit anderen PDFs weiter bearbeitet werden.

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
Bereit anzufangen?
Nuget Downloads 18,560,885 | Version: 2026.4 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.