1. IronPDF
  2. Anleitungen
  3. Wie man einen HTML-String in PDF rendert
Wie man einen HTML-String in PDF in C# rendert | IronPDF

HTML-String in C# in PDF konvertieren

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

IronPDF konvertiert HTML-Strings in PDF-Dokumente in C# unter Verwendung einer Chrome-Rendering-Engine und unterstützt alle HTML5-, CSS3- und JavaScript-Inhalte mit einer einzigen Codezeile für grundlegende Konvertierungen. Die Bibliothek bietet leistungsstarke Funktionen für die Erstellung von PDFs unter Beibehaltung einer perfekten Rendering-Treue.

IronPDF ermöglicht Entwicklern, PDF-Dokumente einfach in C#, F# und VB.NET für .NET Core und .NET Framework zu erstellen. IronPDF unterstützt die Umwandlung jeder HTML-Zeichenkette in eine PDF-Datei, und der Rendering-Prozess verwendet eine voll funktionsfähige Version der Google Chromium-Engine. Dadurch wird sichergestellt, dass HTML-Inhalte genau so angezeigt werden, wie sie in einem modernen Webbrowser erscheinen würden, was die Anwendung ideal für die Erstellung von Berichten, Rechnungen und Dokumenten aus dynamischen HTML-Inhalten macht.

als-Überschrift:2(Schnellstart: HTML-String in Sekundenschnelle in PDF konvertieren)

Umwandlung von HTML-Strings in PDF-Dateien mit IronPDF. Dieser Leitfaden zeigt, wie ein HTML-String in C# mit minimalem Code in ein PDF-Dokument konvertiert werden kann. Perfekt für Entwickler, die PDF-Rendering-Funktionen in ihre Projekte integrieren müssen.

Nuget IconLegen Sie jetzt mit NuGet los, um PDFs zu erstellen:

  1. Installieren Sie IronPDF mit dem NuGet-Paketmanager.

    PM > Install-Package IronPdf

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

    IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute mit der Nutzung von IronPDF in Ihrem Projekt – mit einer kostenlosen Testversion.
    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

IronPDF HTML to PDF conversion workflow showing 5 steps from download to PDF generation with installation command
  1. IronPDF C# Library von NuGet herunterladen
  2. Initialisieren Sie den PDF Renderer und übergeben Sie den HTML-String
  3. Konfigurieren Sie den BasePath für externe Ressourcen im PDF
  4. Konfigurieren Sie die RenderingOptions zur Feinabstimmung der PDF-Ausgabe
  5. Speichern und laden Sie das generierte PDF herunter


Wie konvertiere ich einen einfachen HTML-String in PDF?

Hier ein Beispiel, wie IronPDF einen HTML-String mit der Methode RenderHtmlAsPdf in ein PDF-Dokument umwandelt. Der Parameter ist ein HTML-String, der als PDF gerendert werden soll. Diese Methode ist Teil der Klasse ChromePdfRenderer, die umfassende Kontrolle über die Rendering-Optionen für Ihre PDF-Erzeugungsanforderungen bietet.

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

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

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

Die RenderHtmlAsPdf-Methode gibt ein PdfDocument-Objekt zurück, welches eine Klasse zur Speicherung von PDF-Informationen ist. Dieses Objekt bietet zahlreiche Methoden zur Manipulation von PDFs, einschließlich Zusammenführen von PDFs, Hinzufügen von Wasserzeichen und Einstellen von Sicherheitsoptionen.

Wenn eine HTML-Zeichenfolge von einer externen Quelle bezogen wird und Sie den lokalen Festplattenzugriff oder herkunftsübergreifende Anfragen deaktivieren müssen, setzen Sie die Eigenschaft ChromePdfRenderer.EnableWebSecurity auf true.

Für komplexe HTML-Inhalte, die CSS-Styling enthalten, können Sie Ihre HTML-Strings mit Inline-Styles ergänzen oder mit der Funktion Basis-URLs & Asset Encoding auf externe Stylesheets verweisen:

// Example with inline CSS
var styledHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #333; border-bottom: 2px solid #0066cc; }
        p { line-height: 1.6; }
    </style>
</head>
<body>
    <h1>Professional Report</h1>
    <p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>";

var styledPdf = renderer.RenderHtmlAsPdf(styledHtml);
styledPdf.SaveAs("styled-output.pdf");
// Example with inline CSS
var styledHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #333; border-bottom: 2px solid #0066cc; }
        p { line-height: 1.6; }
    </style>
</head>
<body>
    <h1>Professional Report</h1>
    <p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>";

var styledPdf = renderer.RenderHtmlAsPdf(styledHtml);
styledPdf.SaveAs("styled-output.pdf");
$vbLabelText   $csharpLabel

Wie sieht die generierte PDF-Datei aus?

Dies ist die Datei, die der Code erzeugt hat:

Die generierte PDF-Datei behält die exakte Formatierung und das Styling aus Ihrem HTML-Code bei und eignet sich daher perfekt für die Erstellung von PDF-Berichten oder die Umwandlung von Webinhalten in druckfertige Dokumente.

Wie kann ich externe Assets bei der Konvertierung von HTML in PDF einbeziehen?

Dieses Beispiel zeigt, wie IronPDF ein externes Bild-Asset aus einem optionalen BasePath lädt. Die Eigenschaft BaseUrlOrPath festzulegen, gibt den relativen Dateipfad oder URL-Kontext für Hyperlinks, Bilder, CSS und JavaScript-Dateien an. Diese Funktion ist unerlässlich, wenn Sie mit Bildern in PDFs arbeiten oder wenn Sie auf externe Ressourcen verweisen müssen.

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
$vbLabelText   $csharpLabel

Für fortgeschrittene Szenarien mit komplexen Layouts oder dynamischen Inhalten sollten Sie die Unterstützung von IronPDF für JavaScript-Rendering nutzen:

// Example with JavaScript-generated content
var jsHtml = @"
<html>
<head>
    <script>
        window.onload = function() {
            document.getElementById('dynamic').innerHTML = 
                'Generated on: ' + new Date().toLocaleString();
        };
    </script>
</head>
<body>
    <h1>Dynamic Content Example</h1>
    <div id='dynamic'></div>
</body>
</html>";

// Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds
var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\");
dynamicPdf.SaveAs("dynamic-content.pdf");
// Example with JavaScript-generated content
var jsHtml = @"
<html>
<head>
    <script>
        window.onload = function() {
            document.getElementById('dynamic').innerHTML = 
                'Generated on: ' + new Date().toLocaleString();
        };
    </script>
</head>
<body>
    <h1>Dynamic Content Example</h1>
    <div id='dynamic'></div>
</body>
</html>";

// Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay = 500; // milliseconds
var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\");
dynamicPdf.SaveAs("dynamic-content.pdf");
$vbLabelText   $csharpLabel

Wenn Sie mit externen Assets arbeiten, müssen Sie möglicherweise mit Authentifizierung oder speziellen Headern umgehen. IronPDF unterstützt dies durch die HTTP Request Header-Funktionalität, die es Ihnen ermöglicht, beim Abrufen von Ressourcen Autorisierungs-Token oder benutzerdefinierte Header einzubinden.

Warum ist die Einstellung von BasePath für externe Ressourcen wichtig?

Dies ist die Datei, die der Code erzeugt hat:

Durch die korrekte Einstellung des BasePaths wird sichergestellt, dass alle relativen Verweise in Ihrem HTML korrekt aufgelöst werden. Ohne sie kann IronPDF keine externen Ressourcen wie Bilder, Stylesheets oder Skripte auffinden. Dies ist besonders wichtig, wenn:

  1. Konvertierung von HTML, das auf lokale Dateisystemressourcen verweist
  2. Arbeiten mit Content-Management-Systemen, die relative URLs verwenden
  3. Migration bestehender Webinhalte in das PDF-Format
  4. Erstellen von Vorlagen, die gemeinsame Assets verwenden

Verwenden Sie für webbasierte Ressourcen eine vollständige URL als Basispfad:

// Using a web URL as base path
var webBasedPdf = renderer.RenderHtmlAsPdf(
    "<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>", 
    "https://mywebsite.com"
);
// Using a web URL as base path
var webBasedPdf = renderer.RenderHtmlAsPdf(
    "<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>", 
    "https://mywebsite.com"
);
$vbLabelText   $csharpLabel

Für zusätzliche Kontrolle über den PDF-Erzeugungsprozess können Sie die umfangreiche Dokumentation von IronPDF zu Anpassbare Ränder, Seitenausrichtung und PDF-Komprimierung nutzen, um Ihre Ausgabedateien für verschiedene Anwendungsfälle zu optimieren.

Häufig gestellte Fragen

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

Mit der ChromePdfRenderer-Klasse von IronPDF und der RenderHtmlAsPdf-Methode können Sie eine HTML-Zeichenkette in PDF umwandeln. Instanzieren Sie einfach den Renderer, übergeben Sie die HTML-Zeichenkette an die Methode und speichern Sie das resultierende PdfDocument-Objekt. IronPDF verwendet eine Chrome-Rendering-Engine, um perfekte Wiedergabetreue zu gewährleisten.

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

IronPDF verwendet eine voll funktionsfähige Version der Google Chromium-Engine für das Rendering von HTML in PDF. Dadurch wird sichergestellt, dass Ihre HTML-Inhalte, einschließlich HTML5, CSS3 und JavaScript, genau so angezeigt werden, wie sie in einem modernen Webbrowser erscheinen würden.

Kann ich HTML mit CSS-Styling in PDF konvertieren?

Ja, IronPDF unterstützt die Konvertierung von HTML mit CSS-Styling in PDF. Sie können Inline-Stile direkt in Ihrem HTML-String verwenden oder externe Stylesheets mit der Funktion Base URLs & Asset Encoding referenzieren, um die korrekte Darstellung der gestalteten Inhalte zu gewährleisten.

Wie kann man HTML am schnellsten in PDF konvertieren?

Am schnellsten geht das mit der statischen Methode von IronPDF: IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("Ihr HTML").SaveAs("output.pdf"). Diese einzige Codezeile konvertiert Ihren HTML-String und speichert ihn als PDF-Datei.

Wie behandle ich externe Assets bei der Konvertierung von HTML-Strings?

IronPDF ermöglicht es Ihnen, den BasePath für externe Assets in Ihrer PDF-Datei zu konfigurieren. Dadurch wird sichergestellt, dass Bilder, Stylesheets und andere Ressourcen, auf die in Ihrem HTML-Code verwiesen wird, während des Konvertierungsprozesses korrekt geladen werden.

Kann ich die PDF-Ausgabe bei der Konvertierung von HTML anpassen?

Ja, IronPDF bietet umfangreiche RenderingOptions zur Feinabstimmung Ihrer PDF-Ausgabe. Sie können Seitengröße, Ränder, Kopf- und Fußzeilen und viele andere Aspekte der generierten PDF-Datei über die ChromePdfRenderer-Klasse steuern.

Was kann ich mit der generierten PDF-Datei nach der Konvertierung machen?

Das PdfDocument-Objekt von IronPDF bietet zahlreiche Methoden zur PDF-Bearbeitung, darunter das Zusammenführen von PDFs, das Hinzufügen von Wasserzeichen, das Festlegen von Sicherheitsoptionen und vieles mehr. Die konvertierte PDF-Datei kann auf der Festplatte gespeichert, gestreamt oder nach Bedarf weiterverarbeitet werden.

Wie gehe ich mit der Sicherheit bei der Konvertierung von HTML aus externen Quellen um?

Bei der Konvertierung von HTML aus externen Quellen ermöglicht IronPDF die Einstellung der Eigenschaft EnableWebSecurity auf true für den ChromePdfRenderer. Dadurch werden der lokale Festplattenzugriff und herkunftsübergreifende Anfragen deaktiviert und die Sicherheit erhöht.

Regan Pun
Regan Pun
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Regan absolvierte die University of Reading mit einem BA in Elektroniktechnik. Vor seinem Eintritt bei Iron Software hatte er in seinen vorherigen Stellen laserfokussierte Aufgaben; was er bei Iron Software am meisten genießt, ist das Spektrum an Arbeiten, die er übernehmen darf, sei es den Vertrieb zu unterstützen, ...
Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht