IRONSOFTWAREHOME

Jak dodać numery stron do pliku PDF za pomocą języka C#

Curtis Chau
Curtis Chau
Updated: 29 czerwca 2026

IronPDF umożliwia dodawanie numerów stron do PDF w C# za pomocą ciągów zastępczych {page} i {total-pages} w nagłówkach/stopkach, z opcjami ich stosowania do określonych stron lub sekcji dla ulepszonej nawigacji po dokumencie.

Numery stron to kolejne numery przypisane do każdej strony w dokumencie PDF. Są to niezbędne elementy nawigacji, pomagające czytelnikom w lokalizowaniu konkretnych stron i śledzeniu ich pozycji. Numery stron ułatwiają również cytowanie i odwoływanie się do treści. Dzięki IronPDF dodawanie numerów stron do plików PDF jest bardzo proste.

Szybki start: Łatwe dodawanie numerów stron do plików PDF

Dodaj numery stron do dokumentów PDF za pomocą IronPDF. Za pomocą minimalnego kodu C# można wstawiać dynamiczne numery stron do nagłówków lub stopek, dostosowywać ich położenie oraz określać, na których stronach mają się pojawiać. Niezależnie od tego, czy chodzi o nowe, czy istniejące pliki PDF, IronPDF zapewnia elastyczne rozwiązanie usprawniające nawigację po dokumentach i ich organizację.

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Skopiuj i uruchom ten fragment kodu.

    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");
    C#
  3. 3Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
    arrow pointer

Jak dodać podstawowe numery stron do pliku PDF?

Używając ciągów zastępczych {page} i {total-pages} za pomocą klasy TextHeaderFooter lub HtmlHeaderFooter, można dodać bieżący numer strony i ogólną liczbę stron. Ta funkcja jest niezbędna podczas tworzenia nowych plików PDF lub konwersji dokumentów HTML do formatu PDF, które wymagają profesjonalnego formatowania.

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

Poniżej przedstawiono plik PDF wygenerowany na podstawie powyższego kodu:

Można również dodać nagłówki i stopki z numerami stron bezpośrednio do opcji renderowania klasy ChromePdfRenderer. Takie podejście jest przydatne podczas pracy z opcjami renderowania w celu dostosowania pliku PDF.

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

Podczas pracy z dokumentami o złożonej strukturze należy uwzględnić podziały stron i niestandardowe marginesy, aby zapewnić prawidłowe wyświetlanie numerów stron.

Jak mogę dodać numery stron tylko do określonych stron?

Dzięki IronPDF możesz kontrolować, gdzie pojawiają się numery stron. Niech zaczynają od konkretnej strony lub stosują je do określonych grup, takich jak strony o parzystych indeksach. Ta elastyczność jest cenna podczas generowania raportów PDF lub pracy z dokumentami zawierającymi różne sekcje.

Najpierw przygotuj dokument PDF, aby nadać mu numery stron:

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

Jak ponumerować tylko strony parzyste?

Opierając się na poprzednim przykładzie, ten kod stosuje numery stron wyłącznie do indeksów stron parzystych. Ponieważ filtrowanie dotyczy indeksów stron parzystych, w wynikowym pliku PDF numery pojawiają się na stronach nieparzystych. Indeksy stron zaczynają się od zera, natomiast numery stron od jednego. Technika ta nadaje się do dokumentów o tradycyjnym formatowaniu książkowym lub w przypadku pracy ze scalonymi dokumentami PDF.

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

Jak ponumerować tylko strony nieparzyste?

Dodaj numery stron do stron o nieparzystych numerach indeksowych. Takie podejście jest powszechne w przypadku drukowania dwustronnego, gdzie numery stron powinny pojawiać się tylko na jednej stronie wydrukowanego dokumentu.

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

Jak dodać numer strony tylko na ostatniej stronie?

Dodaj numer strony tylko na ostatniej stronie. Jest to przydatne na stronach podsumowujących lub w celu zaznaczenia końca dokumentu.

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

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

Jak dodać numer strony tylko na pierwszej stronie?

Dodaj numer strony tylko na pierwszej stronie. Rozwiązanie to sprawdza się dobrze w przypadku stron tytułowych lub dokumentów, w których identyfikacja jest wymagana tylko na pierwszej stronie.

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

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

Jak pominąć pierwszą stronę podczas dodawania numerów stron?

Pomiń pierwszą stronę podczas stosowania nagłówka. To ogólne wymaganie dotyczy dokumentów z okładką lub stroną tytułową, na których nie powinny znajdować się numery stron. W przypadku pracy z formularzami PDF lub dokumentami zawierającymi list przewodni technika ta zapewnia profesjonalne formatowanie.

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

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

Jak pominąć pierwszą stronę i rozpocząć numerację od 1 na drugiej stronie?

Pomiń pierwszą stronę i zacznij numerację od drugiej strony, traktując ją jako stronę 1. Takie podejście sprawdza się w przypadku dokumentów, w których strona tytułowa nie powinna być uwzględniana w sekwencji numeracji stron, takich jak prace naukowe lub oficjalne raporty.

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

Aby poznać wszystkie opcje metadanych, odwiedź przewodnik po nagłówkach i stopkach IronPDF.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Zaawansowane techniki numerowania stron

Poza podstawowym numerowaniem stron, IronPDF obsługuje zaawansowane scenariusze, w tym:

  • Numeracja na podstawie sekcji: Różne schematy numeracji dla różnych sekcji dokumentu
  • Liczby rzymskie: Niestandardowe formatowanie dla stron wstępu lub dodatków
  • Wiele systemów numeracji: Łączenie różnych stylów numeracji w jednym dokumencie
  • Dynamiczna liczba stron: Aktualizacja całkowitej liczby stron przy dodawaniu lub kopiowaniu stron

Te techniki są wartościowe przy tworzeniu złożonych dokumentów, takich jak podręczniki techniczne, prace naukowe czy dokumenty prawne wymagające zaawansowanych schematów numerowania stron.

Najlepsze praktyki dodawania numerów stron

Podczas implementacji numerów stron w PDF-ach, warto rozważyć następujące praktyki:

  1. Spójność: Zachowaj spójne pozycjonowanie i formatowanie w całym dokumencie
  2. Czytelność: Upewnij się, że numery stron są wyraźnie widoczne i nie nakładają się na treść
  3. Dostępność: Użyj odpowiednich rozmiarów czcionek i kontrastów dla łatwego czytania
  4. Profesjonalny wygląd: Dopasuj styl numerów stron do ogólnego designu dokumentu

Przestrzeganie tych wytycznych oraz wykorzystanie elastycznych możliwości numerowania stron w IronPDF umożliwia tworzenie profesjonalnych, dobrze zorganizowanych dokumentów PDF, które spełniają określone wymagania.

Często Zadawane Pytania

Jak dodac podstawowe numery stron do PDF w C#?

Dzieki IronPDF, mozesz dodac numery stron, uzywajac ciagow znakowych symboli zastepczych {page} i {total-pages} w klasie TextHeaderFooter lub HtmlHeaderFooter. Po prostu dolacz te symbole do swojego fragmentu HTML naglowka lub stopki, a IronPDF automatycznie zamieni je na biezacy numer strony i calkowita liczbe stron podczas renderowania PDF.

Czy moge dodac numery stron bezposrednio poprzez opcje renderowania?

Tak, mozesz dodac numery stron bezposrednio do opcji renderowania IronPDF's ChromePdfRenderer. To podejscie pozwala ustawic naglowki i stopki z ciagami znakow symboli zastepczych numerow stron jako czesc konfiguracji renderowania, co jest szczegolnie uzyteczne przy dostosowywaniu wyjscia PDF poprzez opcje renderowania.

Jakie symbole zastepcze sa dostepne dla numerowania stron?

IronPDF zapewnia dwa glówne symbole zastepcze dla numerowania stron: {page} wyswietla biezacy numer strony, a {total-pages} pokazuje calkowita liczbe stron w dokumencie. Te symbole sa automatycznie zastepowane wartosciami rzeczywistymi podczas renderowania PDF.

Czy moge zastosowac numery stron tylko do konkretnych stron?

Tak, IronPDF pozwala na kontrolowanie, gdzie numery stron pojawiaja sie w Twoim dokumencie. Mozesz okreslic, ktore strony maja wyswietlac numery stron, dzieki czemu mozesz wykluczyc je z stron tytulowych lub zastosowac je tylko do okreslonych sekcji Twojego PDF.

Czy mozna dostosowac rozmieszczenie i stylizacje numerow stron?

Oczywiscie. Za pomoca klasy HtmlHeaderFooter IronPDF, mozesz dostosowac rozmieszczenie, stylizacje i formatowanie numerow stron uzywajac HTML i CSS. Mozesz kontrolowac ich pozycji, czcionke, rozmiar, kolor, a takze dodawac linie oddzielajace czy inne elementy dekoracyjne.

Czy moge dodac numery stron do istniejacych dokumentow PDF?

Tak, IronPDF wspiera dodawanie numerow stron do nowych PDF jak i istniejacych dokumentow PDF. Mozesz zaladowac istniejacy dokument PDF i zastosowac naglowki lub stopki z numerami stron bez ponownego tworzenia callego dokumentu od nowa.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Odbierz swój BEZPŁATNY

30-dniowy klucz próbny natychmiast.

bullet_checkedNie wymaga karty kredytowej ani tworzenia konta
test_punktorówTestuj w produkcji
bez znaków wodnych
kalendarz_punktorów30 dni w pełni
funkcjonalny produkt
wsparcie_punktorów24/5 wsparcie techniczne
w trakcie okresu próbnego
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta