Wie man Rendering-Optionen in IronPDF mit C#35 verwendet

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

Die Rendering-Optionen in IronPDF passen die PDF-Erzeugung über die Klasse ChromePdfRenderer an und steuern Einstellungen wie Ränder, Kopf- und Fußzeilen, Papiergröße, JavaScript-Ausführung und CSS-Medientypen, um präzise formatierte PDF-Dokumente aus HTML, CSS und anderen Inhaltsquellen zu erstellen.

als-Überschrift:2(Schnellstart: Rendering-Optionen in C# anwenden)

  1. IronPDF über NuGet Package Manager installieren
  2. Erstellen Sie eine ChromePdfRenderer-Instanz
  3. Konfigurieren Sie die Rendering-Optionen über die RenderingOptions-Eigenschaft
  4. Rendering Ihrer Inhalte (HTML, Markdown, etc.) in PDF
  5. Speichern Sie das resultierende PDF-Dokument

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, HtmlHeader = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<div>My Header</div>" }, Language = "en-US", Timeout = 120000 } }
        .RenderHtmlStringAsPdf("<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

Rendering-Optionen bei der PDF-Generierung sind Einstellungen, die bestimmen, wie ein PDF-Dokument erstellt, angezeigt und gedruckt wird. Zu diesen Optionen gehören das Rendern von Formularelementen, das Aktivieren von JavaScript, das Erstellen von Inhaltsverzeichnissen, das Hinzufügen von Kopf- und Fußzeilen, das Anpassen von Rändern, das Einstellen von Papiergrößen und vieles mehr.

Die Klasse ChromePdfRenderer in IronPDF bietet verschiedene Rendering-Optionen zur Anpassung der PDF-Erzeugung. Sie enthält PaperFit, einen Manager, der das Layout von PDF-Seiten steuert und verschiedene Stile wie responsive CSS3-Layouts oder kontinuierlichen Einzug bietet. Bei der Arbeit mit komplexen Dokumenten kann es erforderlich sein, PDFs nach Anwendung von Rendering-Optionen zusammenzuführen oder zu teilen.


## Wie verwende ich Rendering-Optionen in IronPDF? Viele Eigenschaften der Rendering-Optionen sind zwar für die HTML-zu-PDF-Konvertierung konzipiert, funktionieren aber auch mit anderen PDF-Konvertierungsarten. Lassen Sie uns Markdown in PDF rendern und die Ausgabe mithilfe von Rendering-Optionen konfigurieren. Speziell für HTML-Konvertierungen erfahren Sie mehr über die Konvertierung von HTML-Dateien in PDF oder die Konvertierung von HTML-Strings in PDF. ### Warum sollte ich die Rendering-Optionen konfigurieren? Die Konfiguration von Rendering-Optionen stellt sicher, dass PDFs mit exakten Spezifikationen generiert werden: benutzerdefinierte Papiergrößen, spezifische Ränder, Kopf- und Fußzeilen oder aktiviertes JavaScript für dynamische Inhalte. Diese Kontrolle ist entscheidend für die Erstellung neuer PDFs für professionelle Dokumente oder Berichte. ### Was passiert, wenn ich mehrere Rendering-Optionen anwende? Mehrere Rendering-Optionen arbeiten zusammen, um die endgültige PDF-Ausgabe zu erstellen. Jede Option verändert einen bestimmten Rendering-Aspekt, und IronPDF wendet sie während der Konvertierung nacheinander an. Bei der Einstellung von Rändern und Kopfzeilen werden beispielsweise die Einstellungen für die Kopfzeilen beachtet, es sei denn, sie werden mit der Eigenschaft `UseMarginsOnHeaderAndFooter` außer Kraft gesetzt. ```csharp :path=/static-assets/pdf/content-code-examples/how-to/rendering-options-render.cs ``` ### Beispiel für erweiterte Rendering-Optionen Dieses umfassende Beispiel demonstriert die Kombination mehrerer Rendering-Optionen für eine professionelle Dokumentenerstellung. Dieser Ansatz ist hilfreich, wenn Sie [Kopf- und Fußzeilen hinzufügen](https://ironpdf.com/how-to/headers-and-footers/) oder mit [angepassten Papiergrößen](https://ironpdf.com/how-to/custom-paper-size/) arbeiten müssen: ```csharp using IronPdf; using IronPdf.Rendering; // Create renderer with advanced options var renderer = new ChromePdfRenderer(); // Configure paper and layout settings renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait; renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderingOptions.PrintHtmlBackgrounds = true; // Set margins for professional layout renderer.RenderingOptions.MarginTop = 40; // mm renderer.RenderingOptions.MarginBottom = 40; // mm renderer.RenderingOptions.MarginLeft = 20; // mm renderer.RenderingOptions.MarginRight = 20; // mm // Enable JavaScript for dynamic content renderer.RenderingOptions.EnableJavaScript = true; renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 seconds for JS to execute // Add professional header with page numbers renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter { Height = 25, HtmlFragment = @"
Document Title - Page {page} of {total-pages}
", DrawDividerLine = true }; // Add footer with timestamp renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter { Height = 20, HtmlFragment = @"
Generated on {date} at {time}
" }; // Render HTML content string htmlContent = @"

This document demonstrates advanced rendering options.

"; PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent); pdf.SaveAs("professional-document.pdf"); ```
## Was sind die verfügbaren Rendering-Optionen? Erweiterte Optionen definieren PDF-Rendering-Einstellungen wie Ränder, Papierausrichtung, Papiergröße und mehr. Das Verständnis dieser Optionen ist hilfreich, wenn Sie benutzerdefinierte Ränder einstellen oder mit verschiedenen Ansichtseinstellungen und Zoomstufen arbeiten müssen. ### Welche Rendering-Optionen werden am häufigsten verwendet? Zu den am häufigsten verwendeten Rendering-Optionen gehören Randeinstellungen, die Konfiguration der Papiergröße, die Einrichtung von Kopf- und Fußzeilen sowie die Aktivierung von JavaScript. Diese Optionen decken die meisten Anforderungen an die PDF-Anpassung ab. Bei webbasierten Inhalten sorgen JavaScript-Rendering-Optionen für die korrekte Darstellung dynamischer Elemente. ### Wie wähle ich die richtigen Rendering-Optionen? Wählen Sie die Rendering-Optionen entsprechend Ihren Anforderungen: Verwenden Sie Randeinstellungen für Drucklayouts, aktivieren Sie JavaScript für dynamische Webinhalte, konfigurieren Sie Kopf- und Fußzeilen für professionelle Dokumente und passen Sie die Papiergröße für bestimmte Ausgabeformate an. Bei der Arbeit mit Webinhalten sollten Sie CSS-Medientypen für eine optimale Darstellung berücksichtigen. ### Wann sollte ich erweiterte Rendering-Optionen verwenden? Verwenden Sie erweiterte Rendering-Optionen für spezielle Funktionen wie benutzerdefinierte CSS-Injektion, mathematisches LaTeX-Rendering, Graustufenausgabe oder bei der Arbeit mit komplexen Webanwendungen, die ein spezielles JavaScript-Ausführungs-Timing erfordern. Die WaitFor-Klasse bietet eine präzise Kontrolle über Rendering-Verzögerungen für komplexe Szenarien. ### Arbeiten mit Formularelementen Wenn HTML Formularelemente enthält, werden diese von IronPDF automatisch in interaktive PDF-Formulare umgewandelt: ```csharp using IronPdf; var renderer = new ChromePdfRenderer(); // Enable PDF form creation from HTML forms renderer.RenderingOptions.CreatePdfFormsFromHtml = true; // HTML with form elements string formHtml = @"



"; PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml); pdfWithForms.SaveAs("interactive-form.pdf"); ``` Nachstehend finden Sie eine Tabelle, die die verschiedenen verfügbaren 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<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` 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` `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. 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.
`FirstPageNumber` `int` Erste Seitenzahl, die in PDF-Kopf- und Fußzeilen verwendet werden soll. Der Standardwert ist 1.
`TableOfContents` `TableOfContentsTyps` 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` Legt den Kopfzeileninhalt für jede PDF-Seite als HTML fest. Unterstützt 'mail-merge'.
`HtmlFooter`
`InputEncoding` `Encoding` Die Eingabezeichencodierung als String. Der Standardwert ist Encoding.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
`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 Druckerpunkten fest.
`PrintHtmlBackgrounds` `Boolean` 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.
`Timeout` `Integer` Render-Timeout in Sekunden. Der Standardwert ist 60.
`Title` `String` PDF-Dokumentenname und Titel-Metadaten, nützlich für Mail-Merge und automatische Dateibenennung in den Erweiterungen IronPdf MVC und Razor.
`ForcePaperSize` `Boolean` 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.
`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 es auf nichts warten.
Sind Sie bereit, mehr Möglichkeiten zu entdecken? Besuchen Sie unsere Tutorial-Seite: [PDFs konvertieren](https://ironpdf.com/tutorials/convert-pdf/)

Häufig gestellte Fragen

Was sind die Rendering-Optionen bei der PDF-Erstellung?

Rendering-Optionen in IronPDF sind Einstellungen, die steuern, wie PDF-Dokumente über die ChromePdfRenderer-Klasse erstellt, angezeigt und gedruckt werden. Sie umfassen Konfigurationen für Ränder, Kopf- und Fußzeilen, Papiergröße, JavaScript-Ausführung, CSS-Medientypen, Formularelemente und Inhaltsverzeichnisse und ermöglichen eine präzise Anpassung der PDF-Ausgabe von HTML-, CSS- und anderen Inhaltsquellen.

Wie wende ich Rendering-Optionen auf eine PDF-Datei an?

So wenden Sie Rendering-Optionen in IronPDF an: 1) Installieren Sie IronPDF über NuGet, 2) Erstellen Sie eine ChromePdfRenderer-Instanz, 3) Konfigurieren Sie die Einstellungen über die RenderingOptions-Eigenschaft, 4) Rendern Sie Ihre Inhalte (HTML, Markdown usw.) in PDF, und 5) Speichern Sie das resultierende PDF. Sie können mehrere Optionen in einer einzigen Zeile festlegen, z. B. Ränder, CSS-Medientyp, Kopfzeilen und Timeout-Werte.

Kann ich Rendering-Optionen mit Nicht-HTML-Inhalten verwenden?

Ja, viele Eigenschaften der Rendering-Optionen sind zwar für die HTML-zu-PDF-Konvertierung konzipiert, funktionieren aber auch mit anderen PDF-Konvertierungstypen in IronPDF. Sie können Rendering-Optionen bei der Konvertierung von Markdown in PDF oder in andere unterstützte Formate anwenden, so dass Sie unabhängig vom Typ des Quellinhalts die gleiche Kontrolle über die endgültige PDF-Ausgabe haben.

Was ist PaperFit und wie funktioniert es?

PaperFit ist ein Manager innerhalb der ChromePdfRenderer-Klasse von IronPDF, der das Inhaltslayout von PDF-Seiten steuert. Er bietet verschiedene Stile für das Rendering, darunter responsive CSS3-Layouts oder Optionen für den kontinuierlichen Einzug, die sicherstellen, dass Ihre Inhalte entsprechend Ihren spezifischen Anforderungen richtig auf die PDF-Seiten passen.

Warum sollte ich Rendering-Optionen für meine PDFs konfigurieren?

Durch die Konfiguration von Rendering-Optionen in IronPDF wird sichergestellt, dass Ihre PDFs mit den genauen Spezifikationen erstellt werden, die für professionelle Dokumente erforderlich sind. Dazu gehören benutzerdefinierte Papiergrößen, spezifische Ränder, Kopf- und Fußzeilen oder aktiviertes JavaScript für dynamische Inhalte. Dieses Maß an Kontrolle ist entscheidend für die Erstellung von Berichten, Rechnungen oder anderen Dokumenten, die eine präzise Formatierung erfordern.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht