Wie man Rendering-Optionen in IronPDF mit C# verwendet

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

Render-Optionen bei der PDF-Erstellung beziehen sich auf die Einstellungen und Konfigurationen, die bestimmen, wie ein PDF-Dokument erstellt, angezeigt und gedruckt wird. Diese Optionen können eine Vielzahl von Einstellungen umfassen, wie z.B. das Rendern von Formularfeldern, das Aktivieren von JavaScript, das Erstellen eines Inhaltsverzeichnisses, das Hinzufügen von Kopf- und Fußzeilen, das Anpassen der Ränder, das Setzen der PDF-Papiergröße und mehr.

Die ChromePdfRenderer-Klasse in IronPDF bietet verschiedene Render-Optionen, die es Benutzern ermöglichen, anzupassen, wie PDFs erzeugt werden. Sie enthält PaperFit, einen Manager, der steuert, wie Inhalte auf PDF-Seiten angeordnet werden und verschiedene Layoutstile wie responsive CSS3-Layouts oder kontinuierliche Einspeisung bietet.

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.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaTyp = IronPdf.Rendering.PdfCssMediaTyp.Print, HTML-Header = new IronPdf.HTML-HeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Zeitüberschreitung = 120000 } }
        .RenderHtmlZeichenfolgeAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.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


Beispiel für Render-Optionen

Obwohl viele Eigenschaften der Rendering-Optionen speziell für die HTML-zu-PDF-Konvertierung entwickelt wurden, können sie auch in anderen Arten von PDF-Konvertierungen verwendet werden. Lassen Sie uns Markdown-Syntax zu PDF rendern und die Render-Optionen verwenden, um die PDF-Ausgabe zu konfigurieren.

:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;

// Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
// to render HTML/CSS as a PDF document.
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Configure rendering options
// Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = true;

// Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    // HTML fragment to add a header at the top of every page in the PDF.
    HtmlFragment = "<h1>Header Content</h1>"
};

// Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);

// Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0;

// Define a Markdown string that will be rendered as a PDF.
// Markdown text allows basic formatting like bold and italic styles.
string md = "This is some **bold** and *italic* text.";

// Render the Markdown string to a PDF document.
// The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);

// Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf

' Instantiate a ChromePdfRenderer object, which uses a headless version of the Chrome browser
' to render HTML/CSS as a PDF document.
Private renderer As New ChromePdfRenderer()

' Configure rendering options
' Enable printing of HTML backgrounds to ensure all styles are visible.
renderer.RenderingOptions.PrintHtmlBackgrounds = True

' Set HTML header content using HtmlHeaderFooter.
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = "<h1>Header Content</h1>"}

' Set a custom paper size for the PDF in millimeters (width and height).
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)

' Set the top margin to zero to start the content from the very top of the page.
renderer.RenderingOptions.MarginTop = 0

' Define a Markdown string that will be rendered as a PDF.
' Markdown text allows basic formatting like bold and italic styles.
Dim md As String = "This is some **bold** and *italic* text."

' Render the Markdown string to a PDF document.
' The library will convert Markdown syntax into equivalent HTML before rendering it as a PDF.
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)

' Save the generated PDF to a file named "renderingOptions.pdf."
pdf.SaveAs("renderingOptions.pdf")
$vbLabelText   $csharpLabel

Alle Render-Optionen

Wir haben einige erweiterte Optionen, die PDF-Render-Optionen definieren, wie das Anpassen von Rändern, Papierausrichtung, Papiergröße und mehr.

Nachfolgend ist eine Tabelle, die die vielen verschiedenen Optionen veranschaulicht.

Klasse ChromePdfRenderer
Beschreibung Dient zur Definition von PDF-Ausdruckoptionen wie Papiergröße, DPI, Kopf- und Fußzeilen
Eigenschaften / Funktionen Typ Beschreibung
CustomCookies Dictionary Benutzerdefinierte Cookies für das HTML-Rendering. Cookies bleiben zwischen den Rendervorgängen nicht bestehen und müssen jedes Mal neu gesetzt werden.
PaperFit VirtualPaperLayoutManager A manager for setting up virtual paper layouts, controlling how content will be laid out on PDF "paper" pages. Includes options for Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
UseMarginsOnHeaderAndFooter UseMargins Verwenden Sie beim Rendern von Kopf- und Fußzeilen die Randwerte des Hauptdokuments.
CreatePdfFormsFromHtml bool Wandelt alle HTML-Formularelemente in editierbare PDF-Formulare um. Der Standardwert ist true.
CssMediaTyp PdfCssMediaTyp Ermöglicht Media="screen" CSS-Stile und StyleSheets. Der Standardwert ist PdfCssMediaTyp.Screen.
CustomCssUrl zeichenfolge Ermöglicht die Anwendung eines benutzerdefinierten CSS-Stylesheets auf HTML vor dem Rendering. Kann ein lokaler Dateipfad oder eine Remote-URL sein. Nur anwendbar beim Rendern von HTML in PDF.
EnableJavaScript bool Ermöglicht die Ausführung von JavaScript und JSON, bevor die Seite gerendert wird. Ideal für das Drucken aus Ajax-/Angular-Anwendungen. Standardwert ist false.
EnableMathematicalLaTex bool Ermöglicht das Rendern von mathematischen LaTeX-Elementen.
Javascript zeichenfolge Eine benutzerdefinierte JavaScript-Zeichenkette, die nach dem Laden aller HTML-Dateien, aber vor dem PDF-Rendering ausgeführt wird.
JavascriptMessageListener ZeichenfolgeDelegate Ein Methoden-Callback, der immer dann aufgerufen wird, wenn eine JavaScript-Konsolenmeldung des Browsers verfügbar wird.
ErsteSeiteNummer int Erste Seitenzahl, die in PDF-Kopf- und Fußzeilen verwendet werden soll. Der Standardwert ist 1.
Inhaltsverzeichnis InhaltsverzeichnisseTypn Erzeugt ein Inhaltsverzeichnis an der Stelle im HTML-Dokument, an der ein Element mit der ID "ironpdf-toc" gefunden wird.
Graustufen bool Gibt ein schwarz-weißes PDF aus. Der Standardwert ist false.
TextHeader ITextHeaderFooter Legt den Fußzeileninhalt für jede PDF-Seite als Text fest, unterstützt "Mail-Merge" und wandelt URLs automatisch in Hyperlinks um.
TextFooter
HTML-Header HTML-HeaderFooter Legt den Kopfzeileninhalt für jede PDF-Seite als HTML fest. Unterstützt 'mail-merge'.
HTML-Fußzeile
Eingabekodierung Kodierung Die Eingabezeichencodierung als Zeichenfolge. Der Standardwert ist Kodierung.UTF8.
MarginTop double Oberer PDF-"Papier"-Rand in Millimetern. Setzen Sie den Wert auf Null für randlose und kommerzielle Druckanwendungen. Der Standardwert ist 25.
MarginRight double Rechter PDF-"Papier"-Rand in Millimetern. Setzen Sie den Wert auf Null für randlose und kommerzielle Druckanwendungen. Der Standardwert ist 25.
MarginBottom double Unterer PDF-"Papier"-Rand in Millimetern. Setzen Sie den Wert auf Null für randlose und kommerzielle Druckanwendungen. Der Standardwert ist 25.
MarginLeft double Linker PDF-"Papier"-Rand in Millimetern. Setzen Sie den Wert auf Null für randlose und kommerzielle Druckanwendungen. Der Standardwert ist 25.
PaperOrientation PdfPaperOrientation Die PDF-Papierausrichtung, z. B. Hochformat oder Querformat. Der Standardwert ist Hochformat.
PaperSize PdfPaperSize Legt das Papierformat fest
BenutzerdefiniertesPapierformatinZentimetern festlegen double Legt die Papiergröße in Zentimetern fest.
BenutzerdefiniertesPapierformatInZoll Legt die Papiergröße in Zoll fest.
BenutzerdefiniertesPapierformatinMillimetern festlegen Legt die Papiergröße in Millimetern fest.
Benutzerdefinierte Papiergröße in Pixeln oder Punkten festlegen Legt die Papiergröße in Bildschirm-Pixeln oder Druckerpunkten fest.
PrintHtmlBackgrounds Boolesche Gibt an, ob Hintergrundfarben und Bilder aus HTML gedruckt werden sollen. Der Standardwert ist true.
RequestContext RequestContexts Bitte um Kontext für diese Darstellung, um die Isolierung bestimmter Ressourcen wie Cookies zu bestimmen.
Zeitüberschreitung Ganzzahlig Render-Zeitüberschreitung in Sekunden. Der Standardwert ist 60.
Titel Zeichenfolge PDF-Dokumentenname und Titel-Metadaten, nützlich für Mail-Merge und automatische Dateibenennung in den Erweiterungen IronPdf MVC und Razor.
ForcePaperSize Boolesche Erzwingt die exakte Anpassung der Seitengröße an die über IronPdf.ChromePdfRenderOptions.PaperSize festgelegten Werte, indem die Größe der Seite nach der Generierung einer PDF-Datei aus HTML angepasst wird. Hilft bei der Korrektur kleiner Fehler in der Seitengröße beim Rendern von HTML in PDF.
Warten auf Warten auf Ein Wrapper-Objekt, das die Konfiguration für den Wait-for-Mechanismus enthält, mit dem Benutzer auf bestimmte Ereignisse warten können, bevor sie gerendert werden. Standardmäßig wird es auf nichts warten.

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

Häufig gestellte Fragen

Wie kann ich die PDF-Erstellung mit IronPDF optimieren?

Um die PDF-Erstellung mit IronPDF zu optimieren, nutzen Sie die RenderingOptions-Eigenschaft der ChromePdfRenderer-Klasse. Dies ermöglicht die Anpassung von Einstellungen wie JavaScript-Ausführung, Formularfeld-Rendering und benutzerdefinierten Papiergrößen.

Welche Rolle spielt die ChromePdfRenderer-Klasse bei der PDF-Erstellung?

Die ChromePdfRenderer-Klasse in IronPDF ist integraler Bestandteil der PDF-Erstellung, da sie verschiedene Renderoptionen bietet, um zu bestimmen, wie PDFs erstellt werden. Sie unterstützt Funktionen wie die Anpassung der Papiergröße, das Layout-Management und die JavaScript-Ausführung.

Kann ich PDFs aus Markdown-Syntax mit IronPDF erstellen?

Ja, IronPDF unterstützt Rendering-Optionen, die es ermöglichen, Markdown-Syntax in PDFs zu konvertieren. Dies kann erreicht werden, indem die ChromePdfRenderer-Klasse zur Verarbeitung von Markdown-Eingaben konfiguriert wird.

Wie passe ich Ränder und Kopfzeilen in IronPDF an?

Passen Sie Ränder und Kopfzeilen in IronPDF an, indem Sie die RenderingOptions-Eigenschaft innerhalb der ChromePdfRenderer-Klasse nutzen. Dies ermöglicht die Angabe von benutzerdefinierten Rändern und das Hinzufügen von Kopf- und Fußzeilen zu Ihren PDF-Dokumenten.

Ist es möglich, die Ausgabe in Graustufen bei der PDF-Erstellung zu aktivieren?

Ja, IronPDF ermöglicht eine Graustufen-Ausgabe durch Konfiguration der RenderingOptions-Eigenschaft. Diese Option hilft, die Dateigröße zu reduzieren und ist für druckerfreundliche PDF-Erstellung nützlich.

Wie kann ich Papierlayoutstile in IronPDF verwalten?

In IronPDF können Sie Papierlayoutstile mithilfe des PaperFit-Managers in der ChromePdfRenderer-Klasse verwalten. Dies bietet Optionen wie Responsive CSS3 Layouts und Continuous Feed Stil-Setups.

Welche Optionen stehen zur Anpassung der Papiergröße in IronPDF zur Verfügung?

IronPDF bietet Methoden wie SetCustomPaperSizeinCentimeters, SetCustomPaperSizeInInches und SetCustomPaperSizeinMilimeters, um benutzerdefinierte Papiergrößen für PDF-Dokumente zu definieren.

Wie integriere ich benutzerdefiniertes CSS bei der Erstellung von PDFs?

Um benutzerdefiniertes CSS bei der PDF-Erstellung mit IronPDF zu integrieren, verwenden Sie die CustomCssUrl-Eigenschaft, um einen Pfad zu Ihrer CSS-Datei anzugeben. Dies stellt sicher, dass Ihre Stile während des Renderprozesses angewendet werden.

Kann IronPDF aus HTML-Eingabeformularen ausfüllbare PDF-Formulare erstellen?

Ja, IronPDF kann ausfüllbare PDF-Formulare aus HTML-Eingaben erstellen, indem die CreatePdfFormsFromHtml-Eigenschaft in den RenderingOptions aktiviert wird. Diese Funktion ist nützlich für die Entwicklung interaktiver PDFs.

Wie kann ich JavaScript-Probleme bei der PDF-Erstellung beheben?

Stellen Sie sicher, dass JavaScript aktiviert ist, indem Sie die EnableJavaScript-Eigenschaft in den RenderingOptions der ChromePdfRenderer-Klasse auf true setzen. Dies ermöglicht das Ausführen von Skripten während des PDF-Konvertierungsprozesses.

Ist IronPDF vollständig mit .NET 10 kompatibel und hat dies Auswirkungen auf die Rendering-Optionen?

Ja – IronPDF ist vollständig mit .NET 10 kompatibel, und diese Kompatibilität erstreckt sich auch auf die Rendering-Optionen. Das Rendering-Verhalten, wie z. B. Ränder, CSS-Medientypen, JavaScript-Ausführung und Papierformat, funktioniert unter .NET 10 genauso wie in den vorherigen .NET 8/9-Versionen, ohne dass spezielle Konfigurationen oder Feature-Flags erforderlich sind.

Chaknith Bin
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 16,493,056 | Version: 2025.11 gerade veröffentlicht