HTML zu PDF in ASP.NET Core mit C# konvertieren -- IronPDF-Leitfaden

Wie sieht die generierte PDF-Datei aus?

Die Klasse ChromePdfRenderer übernimmt die gesamte komplexe Darstellung und sorgt dafür, dass Ihre HTML-Struktur, CSS-Stile und sogar JavaScript im endgültigen PDF-Output korrekt gerendert werden . Der Rückgabewert ist ein PdfDocument Objekt, dessen BinaryData Eigenschaft Sie direkt als Datei-Download an den Browser streamen können.

Wie konvertiert man dynamische HTML-Zeichenketten?

Bei der Arbeit mit dynamischen Inhalten wie datenbankgestützten Berichten verwenden Sie RenderHtmlAsPdf, um HTML-Zeichenketten direkt zu konvertieren. Diese Methodee akzeptiert beliebiges gültiges HTML-Markup und gibt ein vollständig gerendertes PDF zurück:

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

var renderer = new ChromePdfRenderer();
string htmlContent = BuildDynamicHtml(); // your method to generate HTML
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("dynamic-report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = BuildDynamicHtml() ' your method to generate HTML
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("dynamic-report.pdf")

Dieser Ansatz eignet sich gut zum Generieren von PDF-Dokumenten aus HTML-Vorlagen, die mit Echtzeitdaten, Formulareingaben oder dynamisch generierten Inhalten gefüllt sind. Die Rendering-Engine behält sämtliche CSS-Formatierungen bei, einschließlich benutzerdefinierter Schriftarten, Farben und Tabellenformatierungen. Wenn Ihr HTML-Code auf externe Stylesheets oder Bilder mit relativen Pfaden verweist, übergeben Sie baseUrl als zweites Argument, damit der Renderer diese Assets korrekt auflösen kann.

Wie konvertiert man statische HTML-Dateien von der Festplatte?

Für HTML-Vorlagen, die als physische Dateien gespeichert sind, verwenden Sie RenderHtmlFileAsPdf, um sie zu konvertieren, ohne sie vorher in den Speicher zu laden. Dies ist effizient für große Vorlagen und vermeidet die Verkettung von Zeichenketten:

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html");
pdf.SaveAs("report.pdf");

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlFileAsPdf("wwwroot/templates/report-template.html")
pdf.SaveAs("report.pdf")

Diese Methodee löst automatisch relative Pfade für CSS-Stylesheets, Bilder und andere externe Ressourcen auf, auf die in der Datei verwiesen wird. Sie eignet sich besonders gut, wenn Ihr Designteam separate HTML-Vorlagendateien außerhalb der C#-Codebasis der Anwendung verwaltet. Die Methodee unterstützt CSS-Print-Media-Queries und benutzerdefinierte Schriftarten , sodass für Druckumgebungen erstellte Vorlagen ohne zusätzliche Konfiguration originalgetreu gerendert werden.

Wie wandelt man eine Webseiten-URL in ein PDF um?

Um eine Live-Webseite zu erfassen oder eine URL-zugängliche Seite als PDF zu rendern, verwenden Sie RenderUrlAsPdf. Diese Methodee startet die Chrome-Engine, navigiert zur URL, wartet, bis die Seite vollständig geladen ist, und erfasst dann die gerenderte Ausgabe:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen;
var pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
pdf.SaveAs("webpage.pdf");

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Screen
Dim pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/PDF")
pdf.SaveAs("webpage.pdf")

Die Option WaitFor.RenderDelay weist den Renderer an, nach dem Laden der Seite anzuhalten, bevor er die Erfassung vornimmt. Dies ist von Vorteil für Single-Page-Anwendungen, die ihr DOM erst nach dem Eintreffen der ersten HTML-Antwort mittels JavaScript aufbauen. Durch die Einstellung EnableJavaScript = true wird die vollständige Chrome JavaScript Engine aktiviert, sodass Diagramme, Datengitter und andere JavaScript-gerenderte Komponenten im PDF genauso angezeigt werden wie im Browser.

Wie sieht die Formularoberfläche aus?

Wie werden die Formulardaten im generierten PDF angezeigt?

Für komplexere Dokumentszenarien können Sie PDF-Formulare integrieren oder bestehende PDF-Vorlagen mit vorausgefüllten Feldern bearbeiten. Die Bibliothek unterstützt auch digitale Signaturen für Rechtsdokumente und Verträge, sodass Sie jedem generierten Dokument kryptografisch überprüfbare Signaturen hinzufügen können.

Ein wichtiger Aspekt beim Einbetten von Benutzerdaten in HTML-Strings ist die Datenbereinigung. Um Einschleusungsprobleme zu vermeiden, müssen vom Benutzer eingegebene Zeichenketten vor dem Einfügen in HTML immer maskiert werden. Ein einfacher System.Web.HttpUtility.HtmlEncode(model.CustomerName)-Aufruf für jedes Feld sorgt dafür, dass die Vorlage sicher bleibt, bevor sie an den Renderer übergeben wird.

Wie konfiguriert man Kopfzeilen, Fußzeilen und Wasserzeichen?

Professional PDF-Dokumente benötigen oft Kopf- und Fußzeilen auf jeder Seite sowie Wasserzeichen für Entwürfe oder vertrauliche Dokumente. IronPDF verarbeitet beides über Eigenschaften des RenderingOptions Objekts und die ApplyWatermark Methodee des resultierenden PdfDocument:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    MaxHeight = 25,
    HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    MaxHeight = 20,
    HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
};
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>",
    30, VerticalAlignment.Middle, HorizontalAlignment.Center);
pdf.SaveAs("report-with-watermark.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
    .MaxHeight = 25,
    .HtmlFragment = "<div style='text-align:center'>Annual Report 2024</div>"
}
renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter With {
    .MaxHeight = 20,
    .HtmlFragment = "<div style='text-align:center'>Page {page} of {total-pages}</div>"
}
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.ApplyWatermark("<h2 style='color:red;opacity:0.3'>CONFIDENTIAL</h2>", 30, VerticalAlignment.Middle, HorizontalAlignment.Center)
pdf.SaveAs("report-with-watermark.pdf")

Die Platzhalter {page} und {total-pages} im Footer-HTML werden zur Renderzeit automatisch ersetzt, sodass Sie ohne Nachbearbeitung korrekte Seitenzahlen erhalten. Sie können außerdem Seitenzahlen , Hintergrundbilder oder Vordergrundüberlagerungen sowie benutzerdefinierte Text- oder Bildstempel hinzufügen.

Wie verwendet man CSS Print Media zur Steuerung des PDF-Layouts?

Um sicherzustellen, dass Ihre PDF-Ausgabe den Erwartungen entspricht, verwenden Sie die CSS-Regeln @media print und die Einstellung PdfCssMediaType.Print. IronPDF unterstützt Seitenumbruchsteuerung und benutzerdefinierte Papierformate vollständig:

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
renderer.RenderingOptions.ViewPortWidth = 1024;
renderer.RenderingOptions.MarginTop = 10;
renderer.RenderingOptions.MarginBottom = 10;
renderer.RenderingOptions.MarginLeft = 10;
renderer.RenderingOptions.MarginRight = 10;
string html = @"
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>";
var pdf = renderer.RenderHtmlAsPdf(html);

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
renderer.RenderingOptions.ViewPortWidth = 1024
renderer.RenderingOptions.MarginTop = 10
renderer.RenderingOptions.MarginBottom = 10
renderer.RenderingOptions.MarginLeft = 10
renderer.RenderingOptions.MarginRight = 10

Dim html As String = "
    <style>
        @media print {
            .no-print { display: none; }
            body { font-size: 12pt; }
            .page-break { page-break-after: always; }
        }
        @page {
            size: A4;
            margin: 1cm;
        }
    </style>
    <div class='content'>
        <h1>Professional Report</h1>
        <div class='page-break'></div>
        <h2>Section 2</h2>
    </div>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

Die Verwendung von Print-CSS sorgt dafür, dass Ihre PDF-Dokumente eine professionelle Formatierung erhalten und gleichzeitig unnötige Webelemente wie Navigationsmenüs oder interaktive Schaltflächen ausgeblendet werden. Durch die Einstellung CssMediaType = PdfCssMediaType.Print wird dem Renderer mitgeteilt, dass er Ihre @media print Regeln anstelle der Bildschirmstile anwenden soll. Dies entfernt in der Regel Hintergrunddekorationen und passt die Typografie für die Druckausgabe an. Sie können außerdem benutzerdefinierte Seitenränder konfigurieren und die Seitenausrichtung und -drehung für Breitformat- oder gedrehte Berichte steuern.

Die W3C CSS Paged Media Spezifikation definiert, wie sich Eigenschaften wie @page, page-break-before und widows in der paginierten Ausgabe verhalten sollen. Die Chrome-Engine von IronPDF orientiert sich eng an dieser Spezifikation, sodass nach dem CSS-Standard geschriebene Stile ohne manuelle Anpassungen präzise in das PDF übersetzt werden.