Wie man Rendering-Optionen in IronPDF mit C# verwendet

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. Wenn beispielsweise sowohl Ränder als auch Kopfzeilen festgelegt werden, berücksichtigt der Inhalt der Kopfzeile die Randeinstellungen, sofern diese nicht mit der Eigenschaft UseMarginsOnHeaderAndFooter überschrieben werden.

: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");

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 oder mit angepassten Papiergrößen arbeiten müssen:

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 = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");

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 = @"<div style='text-align: center; padding: 10px;'>
                     <span>Document Title</span> - Page {page} of {total-pages}
                     </div>",
    DrawDividerLine = true
};

// Add footer with timestamp
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    Height = 20,
    HtmlFragment = @"<div style='text-align: center; font-size: 10px;'>
                     Generated on {date} at {time}
                     </div>"
};

// Render HTML content
string htmlContent = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; }
        .content { padding: 20px; }
    </style>
</head>
<body>
    <div class='content'>
        <h1>Professional Document</h1>
        <p>This document demonstrates advanced rendering options.</p>
    </div>
</body>
</html>";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("professional-document.pdf");

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:

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <form>
        <label>Name: <input type='text' name='name' /></label><br>
        <label>Email: <input type='email' name='email' /></label><br>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

// Enable PDF form creation from HTML forms
renderer.RenderingOptions.CreatePdfFormsFromHtml = true;

// HTML with form elements
string formHtml = @"
<html>
<body>
    <form>
        <label>Name: <input type='text' name='name' /></label><br>
        <label>Email: <input type='email' name='email' /></label><br>
        <label>Subscribe: <input type='checkbox' name='subscribe' /></label><br>
        <button type='submit'>Submit</button>
    </form>
</body>
</html>";

PdfDocument pdfWithForms = renderer.RenderHtmlAsPdf(formHtml);
pdfWithForms.SaveAs("interactive-form.pdf");

Nachstehend finden Sie eine Tabelle, die die verschiedenen verfügbaren Optionen veranschaulicht.

Sind Sie bereit, mehr Möglichkeiten zu entdecken? Besuchen Sie unsere Tutorial-Seite: PDFs konvertieren