How to Use the Rendering Options

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 IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { PrintHtmlBackgrounds = true, MarginTop = 0, MarginBottom = 0, CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<h1>Hello Options</h1>")
        .SaveAs("renderingOptions.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Workflow (5 Schritte)

  1. Laden Sie die C#-Bibliothek herunter, um Render-Optionen zu verwenden
  2. Bereiten Sie die HTML-Vermögenswerte oder Datei vor, um in ein PDF-Dokument umgewandelt zu werden
  3. Instanzieren Sie die ChromePdfRenderer-Klasse, um das PDF zu rendern
  4. Zugriff auf die RenderingOptions-Eigenschaft, um Ihre Einstellungen zu konfigurieren
  5. Rendern Sie das PDF im gewünschten Format


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 Wird verwendet, um Optionen für den PDF-Ausdruck zu definieren, wie Papiergröße, DPI, Kopf- und Fußzeilen
Eigenschaften / Funktionen Typ Beschreibung
CustomCookies Dictionary Benutzerdefinierte Cookies für den HTML-Render. Cookies bleiben zwischen den Rendern nicht bestehen und müssen jedes Mal festgelegt werden.
PaperFit VirtualPaperLayoutManager Ein Manager zum Einrichten von virtuellen Papier-Layouts, der steuert, wie Inhalte auf PDF-"Papier"-Seiten angeordnet werden. Beinhaltet Optionen für das Standard-Verhalten von Chrome, Vergrößert, Responsive CSS3-Layouts, Skalierung-zur-Seite & Continuous-Feed-Stil PDF-Seiten-Setups.
UseMarginsOnHeaderAndFooter UseMargins Verwendet die Randwerte des Hauptdokuments beim Rendern von Kopf- und Fußzeilen.
CreatePdfFormsFromHtml bool Verwandelt alle HTML-Formularelemente in bearbeitbare PDF-Formulare. Der Standardwert ist true.
CssMediaType PdfCssMediaType Ermöglicht Media="screen" CSS-Stile und Stylesheets. Der Standardwert ist PdfCssMediaType.Screen.
CustomCssUrl string Erlaubt das Anwenden eines benutzerdefinierten CSS-Stylesheets auf HTML vor dem Rendern. Kann ein lokaler Dateipfad oder eine entfernte URL sein. Nur anwendbar, wenn HTML zu PDF gerendert wird.
EnableJavaScript bool Ermöglicht das Ausführen von JavaScript und JSON, bevor die Seite gerendert wird. Ideal zum Drucken von Ajax / Angular Anwendungen. Der Standardwert ist false.
EnableMathematicalLaTex bool Ermöglicht das Rendern von mathematischen LaTeX-Elementen.
Javascript string Ein benutzerdefinierter JavaScript-String, der ausgeführt wird, nachdem alle HTML geladen wurde, aber bevor das PDF gerendert wird.
JavascriptMessageListener StringDelegate Ein Methoden-Callback, das aufgerufen wird, wann immer eine JavaScript-Konsolennachricht des Browsers verfügbar wird.
FirstPageNumber int Erste Seitennummer, die in PDF-Kopf- und Fußzeilen verwendet wird. Der Standardwert ist 1.
TableOfContents TableOfContentsTypes Erzeugt ein Inhaltsverzeichnis an der Stelle im HTML-Dokument, an der ein Element mit der ID "ironpdf-toc" gefunden wird.
GrayScale bool Gibt ein Schwarz-Weiß-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
HtmlHeader HtmlHeaderFooter Legt den Kopfzeileninhalt für jede PDF-Seite als HTML fest. Unterstützt 'Mail-Merge'.
HtmlFooter
InputEncoding Encoding Die Eingabe-Zeichenkodierung als String. Der Standardwert ist Encoding.UTF8.
MarginTop double Obere PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf null setzen. Der Standardwert ist 25.
MarginRight double Rechter PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf null setzen. Der Standardwert ist 25.
MarginBottom double Unterer PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf null setzen. Der Standardwert ist 25.
MarginLeft double Linker PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf null setzen. Der Standardwert ist 25.
PaperOrientation PdfPaperOrientation Die PDF-Papierausrichtung, wie Hoch- oder Querformat. Der Standardwert ist Hochformat.
PaperSize PdfPaperSize Legt die Papiergröße fest
SetCustomPaperSizeinCentimeters double Legt die Papiergröße in Zentimetern fest.
SetCustomPaperSizeInInches Legt die Papiergröße in Zoll fest.
SetCustomPaperSizeinMilimeters Legt die Papiergröße in Millimetern fest.
SetCustomPaperSizeinPixelsOrPoints Legt die Papiergröße in Bildschirm-Pixeln oder Drucker-Punkten fest.
PrintHtmlBackgrounds Boolean Gibt an, ob Hintergrundfarben und -bilder aus HTML gedruckt werden sollen. Der Standardwert ist true.
RequestContext RequestContexts Anforderungs-Kontext für diesen Render, der die Isolierung bestimmter Ressourcen wie Cookies bestimmt.
Timeout Integer Render-Timeout in Sekunden. Der Standardwert ist 60.
Titel String PDF-Dokumentname und Titelmetadata, nützlich für Mail-Merge und automatische Dateibenennung in den IronPdf MVC- und Razor-Erweiterungen.
ForcePaperSize Boolean Zwingt die Seitengrößen genau auf das zu, was über IronPdf.ChromePdfRenderOptions.PaperSize angegeben wurde, indem die Seite nach der Generierung eines PDFs aus HTML angepasst wird. Hilft, kleine Fehler bei der Seitengröße bei der HTML-zu-PDF-Umwandlung zu korrigieren.
WaitFor WaitFor Ein Wrapper-Objekt, das die Konfiguration für den Warten-auf-Mechanismus enthält, damit Benutzer auf bestimmte Ereignisse vor dem Rendern warten können. Standardmäßig wartet es auf nichts.

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,154,058 | Version: 2025.11 gerade veröffentlicht