So verwenden Sie die Rendering-Optionen

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

von Chaknith Bin

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.

Erster Schritt:
green arrow pointer



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")
VB   C#

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.

KlasseChromePdfRenderer
BeschreibungDient zur Festlegung von PDF-Druckoptionen wie Papiergröße, DPI, Kopf- und Fußzeilen
Eigenschaften / FunktionenTypBeschreibung
CustomCookiesDictionary<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.
PaperFitVirtualPaperLayoutManagerEin 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.
UseMarginsOnHeaderAndFooterUseMarginsVerwenden Sie beim Rendern von Kopf- und Fußzeilen die Randwerte des Hauptdokuments.
CreatePdfFormsFromHtmlboolVerwandelt alle HTML-Formularelemente in bearbeitbare PDF-Formulare. Der Standardwert ist true.
CssMediaTypePdfCssMediaTypeAktiviert Media="screen" CSS-Stile und StyleSheets. Der Standardwert ist PdfCssMediaType.Screen.
CustomCssUrlstringErmö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.
EnableJavaScriptboolErmö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.
EnableMathematicalLaTexboolErmöglicht das Rendern von mathematischen LaTeX-Elementen.
JavascriptstringEine benutzerdefinierte JavaScript-Zeichenkette, die nach dem Laden aller HTML-Dateien, aber vor dem PDF-Rendering ausgeführt wird.
JavascriptMessageListenerStringDelegateEin Methoden-Callback, der immer dann aufgerufen wird, wenn eine JavaScript-Konsolenmeldung des Browsers verfügbar wird.
ErsteSeiteNummerintErste Seitenzahl, die in PDF-Kopf- und -Fußzeilen verwendet werden soll. Der Standardwert ist 1.
InhaltsverzeichnisTableOfContentsTypesErzeugt ein Inhaltsverzeichnis an der Stelle im HTML-Dokument, an der ein Element mit der id "ironpdf-toc" gefunden wird.
GrayScaleboolGibt ein schwarz-weißes PDF aus. Der Standardwert ist false.
TextHeaderITextHeaderFooterLegt den Fußzeileninhalt für jede PDF-Seite als Text fest, unterstützt "Mail-Merge" und wandelt URLs automatisch in Hyperlinks um.
TextFooter
HtmlHeaderHtmlHeaderFooterSetzt den Kopfzeileninhalt für jede PDF-Seite als HTML. Unterstützt 'mail-merge'.
HtmlFooter
InputEncodingKodierungDie Eingabezeichencodierung als String. Der Standardwert ist Encoding.UTF8.
MarginTopdoppeltOberer PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Der Standardwert ist 25.
MarginRightdoppeltRechter PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Standardwert ist 25.
MarginBottomdoppeltUnterer PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Der Standardwert ist 25.
MarginLeftdoppeltLinker PDF-"Papier"-Rand in Millimetern. Für randlose und kommerzielle Druckanwendungen auf Null setzen. Standardwert ist 25.
PapierOrientierungPdfPaperOrientationDie PDF-Papierausrichtung, z. B. Hochformat oder Querformat. Der Standardwert ist Hochformat.
PaperSizePdfPaperSizeEinstellen des Papierformats
SetCustomPaperSizeinCentimetersdoppeltLegt das Papierformat in Zentimetern fest.
SetCustomPaperSizeInInchesLegt das Papierformat in Zoll fest.
SetCustomPaperSizeinMilimetersLegt das Papierformat in Millimetern fest.
SetCustomPaperSizeinPixelsOrPointsLegt die Papiergröße in Bildschirm-Pixeln oder Druckerpunkten fest.
PrintHtmlBackgroundsBoolescheGibt an, ob Hintergrundfarben und Bilder aus HTML gedruckt werden sollen. Der Standardwert ist true.
RequestContextAnfragekontexteAnforderungskontext für diesen Render, der die Isolierung bestimmter Ressourcen wie z. B. Cookies bestimmt.
ZeitüberschreitungIntegerRender-Timeout in Sekunden. Der Standardwert ist 60.
TitelZeichenfolgePDF-Dokumentenname und Titel-Metadaten, nützlich für Mail-Merge und automatische Dateibenennung in den Erweiterungen IronPDF MVC und Razor.
ForcePaperSizeBoolescheErzwingt 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.
WaitForWaitForEin 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.
Chaknith related to Alle Rendering-Optionen

Chaknith Bin

Software-Ingenieur

Chaknith ist der Sherlock Holmes der Entwickler. Zum ersten Mal kam ihm der Gedanke, dass er eine Zukunft in der Softwareentwicklung haben könnte, als er zum Spaß an Code Challenges teilnahm. Sein Schwerpunkt liegt auf IronXL und IronBarcode, aber er ist stolz darauf, Kunden mit jedem Produkt zu helfen. Chaknith nutzt sein Wissen aus direkten Gesprächen mit Kunden, um die Produkte selbst weiter zu verbessern. Sein anekdotisches Feedback geht über Jira-Tickets hinaus und unterstützt die Produktentwicklung, die Dokumentation und das Marketing, um das Gesamterlebnis der Kunden zu verbessern.Wenn er nicht im Büro ist, lernt er über maschinelles Lernen, programmiert und wandert.