1. IronPDF
  2. Anleitungen
  3. Seitenzahlen zu einem PDF hinzufügen
Wie man Seitennummern in PDFs mit C# hinzufügt

Mit C# Seitenzahlen zu einem PDF hinzufügen

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

Mit IronPDF können Sie in C# Seitenzahlen zu PDFs hinzufügen, indem Sie Platzhalterzeichenfolgen {page} und {total-pages} in Kopf- und Fußzeilen verwenden. Außerdem gibt es Optionen, diese auf bestimmte Seiten oder Abschnitte anzuwenden, um die Dokumentnavigation zu verbessern.

Seitenzahlen sind fortlaufende Nummern, die jeder Seite in einem PDF-Dokument zugewiesen werden. Sie sind wichtige Komponenten für die Navigation, die den Lesern helfen, bestimmte Seiten zu finden und ihre Position zu verfolgen. Die Seitenzahlen ermöglichen außerdem eine einfache Zitierung und Referenzierung des Inhalts. Mit IronPDF ist das Hinzufügen von Seitenzahlen zu Ihrer PDF-Datei eine unkomplizierte Aufgabe.

Schnellstart: PDFs mit Seitenzahlen versehen

Fügen Sie Seitenzahlen zu PDF-Dokumenten hinzu — mit IronPDF und minimalem C#-Code. Sie können dynamische Seitenzahlen in Kopf- oder Fußzeilen einfügen, ihre Platzierung anpassen und festlegen, auf welchen Seiten sie erscheinen. IronPDF bietet eine flexible Lösung zur Verbesserung der Dokumentnavigation und -organisation, unabhängig davon, ob es sich um neue oder bestehende PDF-Dateien handelt.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf

  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { HtmlFooter = new IronPdf.HtmlHeaderFooter { HtmlFragment = "<center>{page}of{total-pages}</center>", DrawDividerLine = true } } }
     .RenderHtmlAsPdf("<h1>My multi-page document</h1><div style='page-break-after:always;'></div><h1>Page 2</h1>")
     .SaveAs("numbered-pages.pdf");

  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Minimaler Arbeitsablauf (5 Schritte)

  1. Download der C# PDF Library von NuGet
  2. Laden Sie ein vorhandenes PDF-Dokument oder rendern Sie ein Neues
  3. Verwenden Sie die Platzhalterzeichenfolgen {page} und {total-pages} in der **Kopfzeile** und **Fußzeile**, um Seitenzahlen einzufügen
  4. Seitenzahlen auf bestimmte Seiten oder Abschnitte anwenden
  5. Das resultierende PDF-Dokument überprüfen


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

Mithilfe der Platzhalterzeichenfolgen {page} und {total-pages} können Sie entweder mit der Klasse TextHeaderFooter oder der Klasse HtmlHeaderFooter die aktuelle Seitenzahl und die Gesamtseitenzahl 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");
Imports IronPdf

' Create text header
Private textHeader As New TextHeaderFooter() With {.CenterText = "{page} of {total-pages}"}

' Create html footer
Private htmlFooter As New HtmlHeaderFooter() With {.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"}

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

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

pdf.SaveAs("pdfWithPageNumber.pdf")
$vbLabelText   $csharpLabel

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");
Imports IronPdf

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

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

' Render new PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

pdf.SaveAs("applyPageNumberWithRenderingOptions.pdf")
$vbLabelText   $csharpLabel

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);
Imports IronPdf
Imports System.Linq
Imports System.Collections.Generic

Private multi_page_html As String = "
    <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
Private header As New HtmlHeaderFooter() With {.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"}

' Render PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(multi_page_html)

' Create a Page Range 0..6
Private allPageIndices = Enumerable.Range(0, pdf.PageCount)
$vbLabelText   $csharpLabel

Wie nummeriere ich nur gerade Seiten?

Aufbauend auf dem vorherigen Beispiel wendet dieser Code Seitenzahlen ausschließlich auf gerade Seitenindizes an. Da die Filterung für gerade Seitenindizes gilt, zeigt die resultierende PDF-Datei Zahlen auf ungeraden Seiten. Seitenindizes beginnen bei null, während Seitenzahlen bei eins beginnen. Diese Technik eignet sich für Dokumente im traditionellen Buchformat oder bei der Arbeit mit zusammengeführten PDF-Dokumenten.

: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");
' Get even page indexes (resulting in odd page numbers)
Dim evenPageIndices = allPageIndices.Where(Function(i) i Mod 2 = 0)

pdf.AddHtmlHeaders(header, 1, evenPageIndices)
pdf.SaveAs("EvenPages.pdf")
$vbLabelText   $csharpLabel

Wie kann ich nur ungerade Seiten nummerieren?

Fügen Sie Seitenzahlen zu Seiten mit ungeraden Indexnummern hinzu. Dieser Ansatz ist bei doppelseitigen Druckszenarien üblich, bei denen die Seitenzahlen nur auf einer Seite des gedruckten Dokuments erscheinen sollen.

: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");
' Get odd page indexes (resulting in even page numbers)
Dim oddPageIndexes = allPageIndices.Where(Function(i) i Mod 2 <> 0)

pdf.AddHtmlHeaders(header, 1, oddPageIndexes)
pdf.SaveAs("OddPages.pdf")
$vbLabelText   $csharpLabel

Wie füge ich eine Seitenzahl nur auf der letzten Seite ein?

Fügen Sie nur auf der letzten Seite eine Seitenzahl hinzu. Dies ist nützlich für Zusammenfassungsseiten oder als Hinweis auf das Ende des Dokuments.

: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");
' Last page only
Dim lastPageIndex = New List(Of Integer)() From {pdf.PageCount - 1}

pdf.AddHtmlHeaders(header, 1, lastPageIndex)
pdf.SaveAs("LastPageOnly.pdf")
$vbLabelText   $csharpLabel

Wie füge ich eine Seitenzahl nur auf der ersten Seite ein?

Fügen Sie nur auf der ersten Seite eine Seitenzahl hinzu. Dies eignet sich gut für Deckblätter oder Dokumente, bei denen nur die erste Seite identifiziert werden muss.

: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");
' First page only
Dim firstPageIndex = New List(Of Integer)() From {0}

pdf.AddHtmlHeaders(header, 1, firstPageIndex)
pdf.SaveAs("FirstPageOnly.pdf")
$vbLabelText   $csharpLabel

Wie überspringe ich die erste Seite beim Hinzufügen von Seitenzahlen?

Überspringen Sie die erste Seite, wenn Sie die Kopfzeile anwenden. Diese häufige Anforderung gilt für Dokumente mit Deckblättern oder Titelseiten, die keine Seitenzahlen enthalten sollten. Bei der Arbeit mit PDF-Formularen oder Dokumenten, die ein Anschreiben enthalten, gewährleistet diese Technik eine professionelle Formatierung.

: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");
' Skip the first page
Dim skipFirstPage = allPageIndices.Skip(1)

pdf.AddHtmlHeaders(header, 1, skipFirstPage)
pdf.SaveAs("SkipFirstPage.pdf")
$vbLabelText   $csharpLabel

Wie überspringe ich die erste Seite und beginne mit der Nummerierung von 1 auf der zweiten Seite?

Überspringen Sie die erste Seite und beginnen Sie mit der Nummerierung ab der zweiten Seite und betrachten Sie diese als Seite 1. Dieser Ansatz eignet sich für Dokumente, bei denen das Deckblatt bei der Seitennummerierung nicht mitzählt, wie z. B. bei akademischen Arbeiten oder offiziellen Berichten.

: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");
' Skip the first page and start numbering the second page as page 1
Dim skipFirstPageAndDontCountIt = allPageIndices.Skip(1)

pdf.AddHtmlHeaders(header, 0, skipFirstPageAndDontCountIt)
pdf.SaveAs("SkipFirstPageAndDontCountIt.pdf")
$vbLabelText   $csharpLabel

Um alle Metadatenoptionen zu erkunden, besuchen Sie den IronPDF Headers and Footers Guide.

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.

Häufig gestellte Fragen

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

Mit IronPDF können Sie Seitenzahlen mithilfe der Platzhalterzeichenfolgen {page} und {total-pages} entweder in der Klasse TextHeaderFooter oder HtmlHeaderFooter hinzufügen. Fügen Sie diese Platzhalter einfach in Ihr Kopf- oder Fußzeilen-HTML-Fragment ein, und IronPDF wird sie beim Rendern der PDF-Datei automatisch durch die aktuelle Seitenzahl und die Gesamtseitenzahl ersetzen.

Kann ich Seitenzahlen direkt über die Rendering-Optionen hinzufügen?

Ja, Sie können Seitenzahlen direkt in die Rendering-Optionen von IronPDFs ChromePdfRenderer einfügen. Auf diese Weise können Sie Kopf- und Fußzeilen mit Platzhalterzeichenfolgen für Seitenzahlen als Teil der Rendering-Konfiguration festlegen, was besonders nützlich ist, wenn Sie die PDF-Ausgabe über Rendering-Optionen anpassen.

Welche Platzhalterzeichenfolgen sind für die Seitennummerierung verfügbar?

IronPDF bietet zwei Hauptplatzhalterzeichenfolgen für die Seitennummerierung: {page} zeigt die aktuelle Seitenzahl an, und {total-pages} zeigt die Gesamtzahl der Seiten im Dokument an. Diese Platzhalter werden automatisch durch die tatsächlichen Werte ersetzt, wenn die PDF-Datei gerendert wird.

Kann ich Seitenzahlen nur auf bestimmte Seiten anwenden?

Ja, IronPDF ermöglicht es Ihnen, zu bestimmen, wo in Ihrem Dokument Seitenzahlen erscheinen. Sie können festlegen, auf welchen Seiten Seitenzahlen angezeigt werden sollen, so dass Sie sie von Deckblättern ausschließen oder sie nur auf bestimmte Abschnitte Ihres PDFs anwenden können.

Ist es möglich, die Platzierung und Gestaltung der Seitenzahlen anzupassen?

Unbedingt. Mit der HtmlHeaderFooter-Klasse von IronPDF können Sie die Platzierung, das Styling und die Formatierung von Seitenzahlen mithilfe von HTML und CSS anpassen. Sie können ihre Position, Schriftart, Größe und Farbe steuern und sogar Trennlinien oder andere dekorative Elemente hinzufügen.

Kann ich Seitenzahlen zu bestehenden PDF-Dokumenten hinzufügen?

Ja, IronPDF unterstützt das Hinzufügen von Seitenzahlen sowohl zu neuen PDFs als auch zu bestehenden PDF-Dokumenten. Sie können ein vorhandenes PDF-Dokument laden und Kopf- oder Fußzeilen mit Seitenzahlen hinzufügen, ohne das gesamte Dokument von Grund auf neu erstellen zu müssen.

Jordi Bardia
Jordi Bardia
  Jetzt mit dem Ingenieurteam chatten
Software Ingenieur
Jordi ist am besten in Python, C# und C++ versiert. Wenn er nicht bei Iron Software seine Fähigkeiten einsetzt, programmiert er Spiele. Mit Verantwortung für Produkttests, Produktentwicklung und -forschung trägt Jordi mit immensem Wert zur kontinuierlichen Produktverbesserung bei. Die abwechslungsreiche Erfahrung hält ihn gefordert und engagiert, ...
Weiterlesen
Rezensiert von
Jeff Fritz
Jeffrey T. Fritz
Principal Program Manager - .NET Community Team
Jeff ist außerdem Principal Program Manager für das .NET- und Visual Studio-Team. Er ist der ausführende Produzent der .NET Conf Virtual Conference Series und moderiert ‚Fritz and Friends‘, einen Livestream für Entwickler, der zweimal wöchentlich ausgestrahlt wird. Dort spricht er über Technik und schreibt gemeinsam mit den Zuschauern Code. Jeff schreibt Workshops, Präsentationen und plant Inhalte für die größten Microsoft-Entwicklerveranstaltungen, einschließlich Microsoft Build, Microsoft Ignite, .NET Conf und dem Microsoft MVP Summit.
Bereit anzufangen?
Nuget Downloads 18,560,885 | Version: 2026.4 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.