So verwenden Sie die Rendering-Optionen
Renderoptionen 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 das Rendern von Formularfeldelementen, das Aktivieren von JavaScript, das Erstellen eines Inhaltsverzeichnisses, das Hinzufügen von Kopf- und Fußzeilen, das Anpassen der Ränder, das Festlegen der PDF-Papiergröße und mehr.
Die ChromePdfRenderer-Klasse in IronPDF bietet verschiedene Renderoptionen, die es Benutzern ermöglichen, anzupassen, wie PDFs erstellt werden. Es umfasst PaperFit, einen Manager, der steuert, wie Inhalte auf PDF-Seiten angeordnet werden, und verschiedene Layout-Stile wie responsive CSS3-Layouts oder kontinuierlicher Feed bietet.
Erste Schritte mit IronPDF
Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.
So verwenden Sie die Rendering-Optionen
- Laden Sie die C#-Bibliothek herunter, um Renderoptionen zu verwenden.
- Bereiten Sie die HTML-Assets oder die Datei vor, um sie in ein PDF-Dokument zu konvertieren.
- Instanziieren Sie die ChromePdfRenderer Klasse zum Rendern des PDFs
- Zugriff auf die RenderingOptions Eigenschaft direkt, um Ihre Einstellungen zu konfigurieren
- Rendern Sie das PDF im gewünschten Format.
Rendering-Optionen Beispiel
Trotz der Tatsache, dass viele Rendering-Optionseigenschaften speziell für die HTML-zu-PDF-Konvertierung entwickelt wurden, können sie auch bei anderen Arten von PDF-Konvertierungen verwendet werden. Lassen Sie uns Markdown-Syntax in PDF rendern und die Rendering-Optionen verwenden, um die PDF-Ausgabe zu konfigurieren.
:path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs
using IronPdf;
// Instantiate Renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();
// Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
HtmlFragment = "<h1>Header Content</h1>"
};
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150);
renderer.RenderingOptions.MarginTop = 0;
// Markdown string
string md = "This is some **bold** and *italic* text.";
// Render from markdown string
PdfDocument pdf = renderer.RenderMarkdownStringAsPdf(md);
// Save the PDF
pdf.SaveAs("renderingOptions.pdf");
Imports IronPdf
' Instantiate Renderer
Private renderer As New ChromePdfRenderer()
' Configure rendering options
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header Content</h1>"}
renderer.RenderingOptions.SetCustomPaperSizeinMilimeters(150, 150)
renderer.RenderingOptions.MarginTop = 0
' Markdown string
Dim md As String = "This is some **bold** and *italic* text."
' Render from markdown string
Dim pdf As PdfDocument = renderer.RenderMarkdownStringAsPdf(md)
' Save the PDF
pdf.SaveAs("renderingOptions.pdf")
Alle Rendering-Optionen
Wir haben einige erweiterte Optionen, die PDF-Rendering-Optionen wie die Anpassung von Rändern definieren,
papierausrichtung, Papierformat und mehr.
Die nachstehende Tabelle veranschaulicht die vielen verschiedenen Möglichkeiten.
Klasse | ChromePdfRenderer | |
---|---|---|
Beschreibung | Dient zur Festlegung von PDF-Druckoptionen wie Papiergröße, DPI, Kopf- und Fußzeilen | |
Eigenschaften / Funktionen | Typ | Beschreibung |
CustomCookies | Dictionary<string, string> | 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 | Ein Manager zum Einrichten von Layouts für virtuelles Papier, der steuert, wie der Inhalt auf PDF-"Papier"-Seiten angeordnet wird. Enthält Optionen für Standard-Chrome-Verhalten, gezoomt, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed Stil PDF Seite Setups. |
UseMarginsOnHeaderAndFooter | UseMargins | Verwenden Sie beim Rendern von Kopf- und Fußzeilen die Randwerte des Hauptdokuments. |
CreatePdfFormsFromHtml | bool | Verwandelt alle HTML-Formularelemente in bearbeitbare PDF-Formulare. Der Standardwert ist true. |
CssMediaType | PdfCssMediaType | Aktiviert Media="screen" CSS-Stile und StyleSheets. Der Standardwert ist PdfCssMediaType.Screen. |
CustomCssUrl | string | 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. Der Standardwert ist false. |
EnableMathematicalLaTex | bool | Ermöglicht das Rendern von mathematischen LaTeX-Elementen. |
Javascript | string | Eine benutzerdefinierte JavaScript-Zeichenkette, die nach dem Laden aller HTML-Dateien, aber vor dem PDF-Rendering ausgeführt wird. |
JavascriptMessageListener | StringDelegate | 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 | 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ß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 | ||
HtmlHeader | HtmlHeaderFooter | Setzt den Kopfzeileninhalt für jede PDF-Seite als HTML. Unterstützt 'mail-merge'. |
HtmlFooter | ||
InputEncoding | Kodierung | Die Eingabezeichencodierung als String. Der Standardwert ist Encoding.UTF8. |
MarginTop | doppelt | Oberer PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Der Standardwert ist 25. |
MarginRight | doppelt | Rechter PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Standardwert ist 25. |
MarginBottom | doppelt | Unterer PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Der Standardwert ist 25. |
MarginLeft | doppelt | Linker PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Standardwert ist 25. |
PapierOrientierung | PdfPaperOrientation | Die PDF-Papierausrichtung, z. B. Hochformat oder Querformat. Der Standardwert ist Hochformat. |
PaperSize | PdfPaperSize | Einstellen des Papierformats |
SetCustomPaperSizeinCentimeters | doppelt | Legt das Papierformat in Zentimetern fest. |
SetCustomPaperSizeInInches | Legt das Papierformat in Zoll fest. | |
SetCustomPaperSizeinMilimeters | Legt das Papierformat in Millimetern fest. | |
SetCustomPaperSizeinPixelsOrPoints | 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 | Anfragekontexte | Anforderungskontext für diesen Render, der die Isolierung bestimmter Ressourcen wie z. B. Cookies bestimmt. |
Zeitüberschreitung | Integer | Render-Timeout 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 Einhaltung der über IronPDF.ChromePdfRenderOptions.PaperSize angegebenen Seitengröße durch Größenänderung der Seite nach der Generierung einer PDF-Datei aus HTML. Hilft, kleine Fehler in der Seitengröße beim Rendern von HTML in PDF zu korrigieren. |
WaitFor | WaitFor | 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 auf nichts gewartet. |