Mit C#35 Seitenzahlen zu einem PDF hinzufügen

Wie füge ich einfache Seitenzahlen zu einer PDF-Datei hinzu?

Mit den Platzhalterzeichenfolgen {page} und {total-pages} mit der Klasse TextHeaderFooter oder HtmlHeaderFooter können Sie die aktuelle Seitenzahl und die Gesamtzahl der Seiten hinzufügen. Diese Funktionalität ist unerlässlich für die Erstellung neuer PDFs oder die Konvertierung von HTML in PDF-Dokumente, die eine professionelle Formatierung erfordern.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs

using IronPdf;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};

// Create html footer
HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

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

// Add header and footer
pdf.AddTextHeaders(textHeader);
pdf.AddHtmlFooters(htmlFooter);

pdf.SaveAs("pdfWithPageNumber.pdf");

Das von dem obigen Code erzeugte PDF wird unten gezeigt:

Sie können auch Kopf- und Fußzeilen mit Platzhalterzeichenfolgen für Seitenzahlen direkt zu den Rendering-Optionen des ChromePdfRenderer hinzufügen. Dieser Ansatz ist nützlich, wenn Sie mit Rendering-Optionen arbeiten, um Ihre PDF-Ausgabe anzupassen.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs

using IronPdf;

// Add header and footer to rendering options
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

string html = @"
    <h1>Hello World!</h1>
<div style='page-break-after: always;'/>
    <h1>2nd Page!</h1>";

// Render new PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

pdf.SaveAs("applyPageNumberWithRenderingOptions.pdf");

Bei der Arbeit mit komplexen Dokumenten sollten Sie Seitenumbrüche und angepasste Ränder berücksichtigen, damit die Seitenzahlen korrekt angezeigt werden.

Wie kann ich Seitenzahlen nur auf bestimmten Seiten hinzufügen?

Mit IronPDF können Sie steuern, wo die Seitenzahlen erscheinen. Lassen Sie sie auf einer bestimmten Seite beginnen oder wenden Sie sie auf bestimmte Gruppen an, z. B. auf Seiten mit gerader Indexierung. Diese Flexibilität ist wertvoll bei der Erstellung von PDF-Berichten oder bei der Arbeit mit Dokumenten, die verschiedene Abschnitte enthalten.

Bereiten Sie zunächst das PDF-Dokument vor, um Seitenzahlen anzubringen:

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs

using IronPdf;
using System.Linq;
using System.Collections.Generic;

string multi_page_html = @"
    <p>This is the 1st Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 3rd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 4th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 5th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 6th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 7th Page</p>";

// Create header
HtmlHeaderFooter header = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

// Render PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(multi_page_html);

// Create a Page Range 0..6
var allPageIndices = Enumerable.Range(0, pdf.PageCount);

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs

// Get even page indexes (resulting in odd page numbers)
var evenPageIndices = allPageIndices.Where(i => i % 2 == 0);

pdf.AddHtmlHeaders(header, 1, evenPageIndices);
pdf.SaveAs("EvenPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs

// Get odd page indexes (resulting in even page numbers)
var oddPageIndexes = allPageIndices.Where(i => i % 2 != 0);

pdf.AddHtmlHeaders(header, 1, oddPageIndexes);
pdf.SaveAs("OddPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs

// Last page only
var lastPageIndex = new List<int>() { pdf.PageCount - 1 };

pdf.AddHtmlHeaders(header, 1, lastPageIndex);
pdf.SaveAs("LastPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs

// First page only
var firstPageIndex = new List<int>() { 0 };

pdf.AddHtmlHeaders(header, 1, firstPageIndex);
pdf.SaveAs("FirstPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs

// Skip the first page
var skipFirstPage = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 1, skipFirstPage);
pdf.SaveAs("SkipFirstPage.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs

// Skip the first page and start numbering the second page as page 1
var skipFirstPageAndDontCountIt = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 0, skipFirstPageAndDontCountIt);
pdf.SaveAs("SkipFirstPageAndDontCountIt.pdf");

Fortgeschrittene Seitennummerierungstechniken

Neben der einfachen Seitennummerierung unterstützt IronPDF auch erweiterte Szenarien:

• Abschnittsbezogene Nummerierung: Unterschiedliche Nummerierungsschemata für verschiedene Dokumentabschnitte
• Römische Ziffern: Benutzerdefinierte Formatierung für Vorwort- oder Anhangseiten
• Mehrere Nummerierungssysteme: Die Kombination verschiedener Nummerierungsstile in einem einzigen Dokument
• Dynamische Seitenzahlen: Aktualisierung der Gesamtseitenzahl beim Hinzufügen oder Kopieren von Seiten

Diese Techniken sind bei der Erstellung komplexer Dokumente wie technischer Handbücher, akademischer Abhandlungen oder juristischer Dokumente, die ausgeklügelte Seitennummerierungsschemata erfordern, von großem Nutzen.

Best Practices für Seitenzahlen

Beachten Sie bei der Implementierung von Seitenzahlen in Ihren PDFs die folgenden Praktiken:

1. Konsistenz: Achten Sie auf eine einheitliche Positionierung und Formatierung in Ihrem Dokument
2. Lesbarkeit: Stellen Sie sicher, dass die Seitenzahlen deutlich sichtbar sind und sich nicht mit dem Inhalt überschneiden
3. Zugänglichkeit: Geeignete Schriftgrößen und Kontraste für eine gute Lesbarkeit verwenden
4. Professionelles Erscheinungsbild: Passen Sie den Stil der Seitenzahlen an das Gesamtdesign Ihres Dokuments an

Wenn Sie diese Richtlinien befolgen und die flexiblen Seitennummerierungsfunktionen von IronPDF nutzen, können Sie professionelle, gut organisierte PDF-Dokumente erstellen, die Ihren spezifischen Anforderungen entsprechen.