Kopf- und Fußzeilen in PDF-Dateien mit C#35; und IronPDF hinzufügen

Wie kann ich beim Rendern Kopf- und Fußzeilen hinzufügen?

Alternativ können Sie auch direkt eine Kopf-/Fußzeile hinzufügen, indem Sie die RenderingOptions des Renderers verwenden. Dadurch werden die Kopf- und Fußzeilen während des Rendering-Prozesses hinzugefügt, was effizienter ist als das Hinzufügen nach der Erstellung der PDF-Datei. Dieser Ansatz empfiehlt sich, wenn Sie den Inhalt der Kopf- und Fußzeilen im Voraus kennen, da er die Bearbeitungszeit verkürzt und von Anfang an eine einheitliche Formatierung gewährleistet.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-render-with-textheaderfooter.cs

using IronPdf;

// Instantiate renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and add to rendering options
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};


// Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Render PDF with header and footer
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
pdf.SaveAs("renderWithTextHeaderFooter.pdf");

Wie sieht die angepasste Textüberschrift aus?

Welche Schriftarten sind standardmäßig verfügbar?

Sie können sehen, welche Schriftarten standardmäßig in der IronPDF API-Referenz verfügbar sind. IronPDF unterstützt eine breite Palette von Standardschriftarten, darunter Arial, Times New Roman, Helvetica, Courier und deren Varianten. Wenn Sie benutzerdefinierte Schriftarten benötigen, erfahren Sie mehr über die Verwaltung von Schriftarten in IronPDF.

Wie wende ich Ränder durch Rendering-Optionen an?

Wenn Sie in den RenderingOptions von ChromePdfRenderer Randwerte hinzufügen, gelten diese Ränder auch für die Kopf- und Fußzeile. Dieser Ansatz bietet eine zentrale Möglichkeit zur Verwaltung der Ränder in Ihrem gesamten Dokument, einschließlich Kopf- und Fußzeilen sowie des Hauptinhalts. Für fortgeschrittene Anpassungen der Seitenränder lesen Sie bitte unseren Leitfaden zum Einrichten von benutzerdefinierten Seitenrändern.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-rendering-options-margins.cs

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Margin values are in mm
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header;
renderer.RenderingOptions.TextFooter = footer;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

Warum sollte ich UseMarginsOnHeaderAndFooter vermeiden?

Die Eigenschaft UseMarginsOnHeaderAndFooter von RenderingOptions ist für diesen Anwendungsfall nicht geeignet. Sie wendet dieselben Randwerte auf die Kopf-, Fuß- und Hauptinhalte an, was dazu führen kann, dass sich die Kopfzeile mit dem Dokumenteninhalt überschneidet. Diese Eigenschaft ist hauptsächlich dazu gedacht, Kopf- und Fußzeilen zu bestehenden PDFs mit der AddTextHeadersAndFooters-Methode hinzuzufügen. Um eine bessere Kontrolle über das Layout zu erhalten, sollten Sie Seitenumbrüche zur Steuerung des Inhaltsflusses in Betracht ziehen.

Was ist Dynamic Margin Sizing?

Statische Ränder stellten ein Problem dar, wenn der Inhalt der Kopfzeilen zwischen den Dokumenten variierte. Anpassungen waren nicht nur für die Kopf- und Fußzeilenränder erforderlich, sondern auch für den HTML-Hauptrand, um unterschiedliche Kopf- und Fußzeilengrößen zu berücksichtigen. Daher haben wir eine dynamische Randanpassung implementiert, bei der sich die Höhe der Kopf- und Fußzeile dynamisch an den Inhalt anpasst und der Haupt-HTML-Code entsprechend neu positioniert wird. Diese Funktion ist besonders nützlich bei der Arbeit mit responsiven CSS-Layouts. Verwenden Sie den unten stehenden Code, um diese Funktion auszuprobieren:

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-dynamic-marigns.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
    // Enable the dynamic height feature
    MaxHeight = HtmlHeaderFooter.FragmentHeight,
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");
pdf.SaveAs("dynamicHeaderSize.pdf");

Welche Platzhalter sollte ich am häufigsten verwenden?

Um mehr über {page} und {total-pages} zu erfahren, besuchen Sie den IronPDF Page Numbers Guide. Diese Platzhalter werden am häufigsten verwendet, da sie wichtige Navigationsinformationen liefern. Die Platzhalter für Datum und Uhrzeit sind besonders nützlich für Dokumente, die einen Zeitstempel benötigen, wie z. B. Berichte oder Rechnungen.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-mail-merge.cs

using IronPdf;

// Create header and footer
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "{page} of {total-pages}",
    LeftText = "Today's date: {date}",
    RightText = "The time: {time}",
};

TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "Current URL: {url}",
    LeftText = "Title of the HTML: {html-title}",
    RightText = "Title of the PDF: {pdf-title}",
};

Wie kontrolliere ich die Ränder von HTML-Kopf- und Fußzeilen?

Ähnlich wie bei den Kopf- und Fußzeilen von Texten werden bei den Methoden AddHtmlHeaders und AddHtmlFooters vordefinierte Ränder verwendet. Um benutzerdefinierte Ränder anzuwenden, verwenden Sie eine Überladung der Funktionen mit den angegebenen Randwerten. Um den gesamten Inhalt ohne Ränder zu umspannen, setzen Sie die Ränder in der Überladungsfunktion auf 0. Dieses Maß an Kontrolle ist für die Erstellung professioneller Dokumente mit spezifischen Layoutanforderungen unerlässlich.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter-margins.cs

// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);

Kann ich beim Rendern HTML-Kopf-/Fußzeilen hinzufügen?

Das Hinzufügen von Kopf- und Fußzeilen kann auch direkt über die RenderingOptions des Renderers erfolgen. Dadurch werden die HTML-Kopf- und Fußzeilen während des Rendering-Prozesses hinzugefügt, was effizienter ist als eine Nachbearbeitung. Diese Methode ist besonders nützlich bei der Erstellung von PDFs aus HTML-Dateien oder bei der Konvertierung von URLs in PDFs.

:path=/static-assets/pdf/content-code-examples/how-to/headers-and-footers-htmlheaderfooter.cs

using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);

Was sind die Auswirkungen auf die Leistung?

Text-Kopf-/Fußzeilen werden schneller gerendert, da sie kein HTML-Parsing und keine CSS-Verarbeitung erfordern. HTML-Kopf-/Fußzeilen bieten mehr Flexibilität, erfordern aber zusätzliche Rendering-Zeit, die proportional zu ihrer Komplexität ist. Bei der Arbeit mit großen Dokumenten oder der Stapelverarbeitung wird der Leistungsunterschied deutlicher. Für eine optimale Leistung in hochvolumigen Szenarien sollten Sie unseren Leitfaden zur asynchronen PDF-Generierung beachten.

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich hier unsere Tutorial-Seite an: PDFs erstellen