Dodawanie nagłówków i stopek w plikach PDF przy użyciu języka C# i biblioteki IronPDF

Updated: 3 czerwca 2026

IronPDF umożliwia łatwe dodawanie nagłówków i stopek do dokumentów PDF w C# używając metod takich jak AddTextHeaders i AddTextFooters dla prostego tekstu lub AddHtmlHeaders i AddHtmlFooters dla treści opartych na HTML z pełnym wsparciem stylizacji CSS. Ta potężna funkcjonalność jest niezbędna do tworzenia profesjonalnych plików PDF z zachowaniem spójnego wizerunku marki, numeracji stron i metadanych dokumentu.

Chcesz umieścić numery stron, logo firmy lub datę u góry lub u dołu każdej strony w dokumencie PDF? IronPDF ułatwia stosowanie nagłówków i stopek w plikach PDF w projekcie C#. Niezależnie od tego, czy generujesz raporty, faktury czy inne dokumenty biznesowe, nagłówki i stopki stanowią kluczowe elementy nawigacyjne i identyfikacyjne, które zwiększają użyteczność dokumentu.

Szybki start: Dodawanie nagłówków i stopek do plików PDF w języku C#

Bez wysiłku dodawaj nagłówki i stopki do dokumentów PDF za pomocą IronPDF w języku C#. W tym przewodniku pokazano, jak w kilka sekund zastosować nagłówki i stopki tekstowe z numerami stron i niestandardowym tekstem. Użyj metod AddTextHeaders i AddTextFooters, aby szybko poprawić prezentację PDF. Zapisz zaktualizowany plik PDF z minimalną ilością kodu, zapewniając profesjonalny wygląd dokumentów.

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Skopiuj i uruchom ten fragment kodu.

new IronPdf.ChromePdfRenderer { RenderingOptions = { TextHeader = new IronPdf.TextHeaderFooter { CenterText = "Report • {date}" }, TextFooter = new IronPdf.TextHeaderFooter { RightText = "Page {page} of {total-pages}" } } }
    .RenderHtmlAsPdf("<h1>Hello World!</h1>")
    .SaveAs("withHeadersFooters.pdf");

new IronPdf.ChromePdfRenderer { RenderingOptions = { TextHeader = new IronPdf.TextHeaderFooter { CenterText = "Report • {date}" }, TextFooter = new IronPdf.TextHeaderFooter { RightText = "Page {page} of {total-pages}" } } }
    .RenderHtmlAsPdf("<h1>Hello World!</h1>")
    .SaveAs("withHeadersFooters.pdf");

3Wdrożenie do testowania w środowisku produkcyjnym

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

Minimalny proces (5 kroków)

Pobierz bibliotekę C#, aby dodać nagłówki i stopki
Załaduj istniejący plik PDF lub wygeneruj nowy
Użyj metod AddTextHeaders i AddTextFooters, aby dodać nagłówki i stopki tekstowe
Użyj metod AddHtmlHeaders i AddHtmlFooters, aby dodać nagłówki i stopki HTML
Dodaj nagłówki i stopki w czasie renderowania, konfigurując opcje RenderingOptions

Jak dodać nagłówek/stopkę do tekstu?

Aby stworzyć nagłówek/stopkę tylko z tekstem, utwórz obiekt TextHeaderFooter, dodaj pożądany tekst i dodaj obiekt do swojego PDF. Klasa TextHeaderFooter zapewnia prosty sposób dodawania spójnych elementów tekstowych na wszystkich stronach dokumentu. Ta metoda jest szczególnie przydatna w przypadku prostych nagłówków i stopek, które nie wymagają skomplikowanego formatowania ani stylizacji.

using IronPdf;

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

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

using IronPdf;

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

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")

Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")

Jak mogę dodać nagłówki/stopki podczas renderowania?

Alternatywnie, można bezpośrednio dodać nagłówek/stopkę, używając RenderingOptions renderera. Spowoduje to dodanie nagłówka i stopki tekstu podczas renderowania, co jest bardziej wydajne niż dodawanie ich po utworzeniu pliku PDF. Takie podejście jest zalecane, gdy znasz z góry treść nagłówka i stopki, ponieważ skraca to czas przetwarzania i zapewnia spójne formatowanie od samego początku.

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

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

Imports IronPdf

' Instantiate renderer
Dim renderer As New ChromePdfRenderer()

' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

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

Imports IronPdf

' Instantiate renderer
Dim renderer As New ChromePdfRenderer()

' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

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

Jak mogę dostosować właściwości tekstu i separatorów?

W klasie TextHeaderFooter, można ustawić tekst dla lewego, środkowego i prawego położenia. Dodatkowo można dostosować rodzaj i rozmiar czcionki tekstu oraz dodać separator o niestandardowym kolorze, konfigurując odpowiednie właściwości. Te opcje dostosowywania pozwalają tworzyć nagłówki i stopki zgodne z wizerunkiem firmy lub wytycznymi dotyczącymi stylu dokumentów. Funkcja linii oddzielającej jest szczególnie przydatna do tworzenia wizualnego rozdzielenia nagłówka/stopki od głównej treści.

using IronPdf;
using IronPdf.Font;
using IronSoftware.Drawing;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Center text", // Set the text in the center
    LeftText = "Left text", // Set left-hand side text
    RightText = "Right text", // Set right-hand side text
    Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic, // Set font
    FontSize = 16, // Set font size
    DrawDividerLine = true, // Draw Divider Line
    DrawDividerLineColor = Color.Red, // Set color of divider line
};

using IronPdf;
using IronPdf.Font;
using IronSoftware.Drawing;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Center text", // Set the text in the center
    LeftText = "Left text", // Set left-hand side text
    RightText = "Right text", // Set right-hand side text
    Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic, // Set font
    FontSize = 16, // Set font size
    DrawDividerLine = true, // Draw Divider Line
    DrawDividerLineColor = Color.Red, // Set color of divider line
};

Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing

' Create text header
Private textHeader As New TextHeaderFooter With {
	.CenterText = "Center text",
	.LeftText = "Left text",
	.RightText = "Right text",
	.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
	.FontSize = 16,
	.DrawDividerLine = True,
	.DrawDividerLineColor = Color.Red
}

Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing

' Create text header
Private textHeader As New TextHeaderFooter With {
	.CenterText = "Center text",
	.LeftText = "Left text",
	.RightText = "Right text",
	.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
	.FontSize = 16,
	.DrawDividerLine = True,
	.DrawDividerLineColor = Color.Red
}

Jak wygląda dostosowany nagłówek tekstu?

Przykład wyrównania tekstu pokazujący opcje pozycjonowania tekstu po lewej, w środku i po prawej stronie

Jakie czcionki są dostępne domyślnie?

Dostępne domyślnie czcionki można sprawdzić w Dokumentacji API IronPDF. IronPDF obsługuje szeroką gamę standardowych czcionek, w tym Arial, Times New Roman, Helvetica, Courier i ich odmiany. Jeśli potrzebujesz niestandardowych czcionek, dowiedz się więcej o zarządzaniu czcionkami w IronPDF.

Jak ustawić marginesy dla nagłówków/stopek tekstu?

Domyślnie nagłówki i stopki tekstu w IronPDF mają predefiniowane marginesy. Jeśli chcesz, aby nagłówek tekstowy obejmował całą szerokość dokumentu PDF, określ wartości marginesu równe 0. Można to osiągnąć, ustawiając marginesy bezpośrednio w funkcjach AddTextHeaders i AddTextFooters lub przez RenderingOptions w ChromePdfRenderer. Zrozumienie kontroli marginesów ma kluczowe znaczenie dla uzyskania układów o idealnej rozdzielczości, zwłaszcza podczas pracy z niestandardowymi rozmiarami papieru.

using IronPdf;

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

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

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

pdf.AddTextHeaders(header, 35, 30, 25); // Left Margin = 35, Right Margin  = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25); // Margin values are in mm

using IronPdf;

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

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

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

pdf.AddTextHeaders(header, 35, 30, 25); // Left Margin = 35, Right Margin  = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25); // Margin values are in mm

Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

Dim header As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

Dim footer As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

pdf.AddTextHeaders(header, 35, 30, 25) ' Left Margin = 35, Right Margin = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25) ' Margin values are in mm

Imports IronPdf

' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

Dim header As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

Dim footer As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

pdf.AddTextHeaders(header, 35, 30, 25) ' Left Margin = 35, Right Margin = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25) ' Margin values are in mm

Jak zastosować marginesy za pomocą opcji renderowania?

Jeśli dodasz wartości marginesów w RenderingOptions z ChromePdfRenderer, te marginesy będą również miały zastosowanie do nagłówka i stopki. Takie podejście zapewnia scentralizowany sposób zarządzania marginesami w całym dokumencie, w tym w nagłówkach, stopkach i głównej treści. Aby uzyskać więcej informacji na temat zaawansowanego dostosowywania marginesów, zapoznaj się z naszym przewodnikiem dotyczącym ustawiania niestandardowych marginesów.

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

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

Imports IronPdf

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()

Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}

Private footer As New TextHeaderFooter With {.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

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

Imports IronPdf

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()

Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}

Private footer As New TextHeaderFooter With {.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

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

Dlaczego powinienem unikać `UseMarginsOnHeaderAndFooter`?

Właściwość UseMarginsOnHeaderAndFooter na RenderingOptions nie jest odpowiednia dla tego przypadku użycia. Zastosowano te same wartości marginesów dla nagłówka, stopki i głównej treści, co może spowodować, że nagłówek będzie zachodził na treść dokumentu. Ta właściwość jest głównie przeznaczona do stosowania nagłówków i stopek do istniejących PDF-ów, używając metody AddTextHeadersAndFooters. Aby uzyskać lepszą kontrolę nad układem, warto rozważyć użycie podziałów stron do zarządzania przepływem treści.

Czym jest dynamiczne dostosowywanie marginesów?

Problem stanowiły stałe marginesy, gdy zawartość nagłówków różniła się w poszczególnych dokumentach. Konieczne było dostosowanie nie tylko marginesów nagłówka i stopki, ale także głównego marginesu HTML, aby uwzględnić różne rozmiary nagłówków i stopek. W związku z tym wdrożyliśmy funkcję dynamicznego dostosowywania marginesów, w której wysokość nagłówka i stopki dostosowuje się dynamicznie w zależności od treści, a główny kod HTML odpowiednio się przesuwa. Ta funkcja jest szczególnie przydatna podczas pracy z responsywnymi układami CSS. Użyj poniższego kodu, aby wypróbować tę funkcję:

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

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

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

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

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

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

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

Jak dodać metadane do nagłówków/stopek tekstu?

Możesz łatwo dodać metadane, takie jak numery stron, datę i tytuł pliku PDF, umieszczając w tekście ciągi znaków zastępczych. Te symbole zastępcze są automatycznie zastępowane odpowiednimi wartościami podczas renderowania pliku PDF. Ta funkcja jest niezbędna do tworzenia dynamicznych nagłówków i stopek, które aktualizują się automatycznie na podstawie właściwości dokumentu. Oto wszystkie dostępne opcje metadanych:

{page}: Bieżący numer strony.
{total-pages}: Całkowita liczba stron.
{url}: Web URL, z którego dokument PDF został wyrenderowany.
{date}: Bieżąca data.
{time}: Bieżący czas.
{html-title}: Tytuł HTML określony w tagu title w HTML.
{pdf-title}: Tytuł PDF wyspecyfikowany w metadanych PDF.

Których symboli zastępczych powinienem używać najczęściej?

Aby dowiedzieć się więcej o {page} i {total-pages}, odwiedź Przewodnik po numerach stron IronPDF. Te zastępniki są najczęściej używane, ponieważ dostarczają istotnych informacji nawigacyjnych. Zastępcze symbole daty i godziny są szczególnie przydatne w dokumentach wymagających śledzenia znaczników czasu, takich jak raporty lub faktury.

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}",
};

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}",
};

Imports IronPdf

' Create header and footer
Private textHeader As New TextHeaderFooter With {
	.CenterText = "{page} of {total-pages}",
	.LeftText = "Today's date: {date}",
	.RightText = "The time: {time}"
}

Private textFooter As New TextHeaderFooter With {
	.CenterText = "Current URL: {url}",
	.LeftText = "Title of the HTML: {html-title}",
	.RightText = "Title of the PDF: {pdf-title}"
}

Imports IronPdf

' Create header and footer
Private textHeader As New TextHeaderFooter With {
	.CenterText = "{page} of {total-pages}",
	.LeftText = "Today's date: {date}",
	.RightText = "The time: {time}"
}

Private textFooter As New TextHeaderFooter With {
	.CenterText = "Current URL: {url}",
	.LeftText = "Title of the HTML: {html-title}",
	.RightText = "Title of the PDF: {pdf-title}"
}

Jak dodać nagłówki/stopki HTML?

Możesz dodatkowo dostosować nagłówek/stopkę, korzystając z HTML i CSS. Aby stworzyć nagłówek/stopkę HTML, użyj klasy HtmlHeaderFooter. Takie podejście zapewnia maksymalną elastyczność, umożliwiając umieszczanie obrazów, złożonych układów oraz stylizowanych treści w nagłówkach i stopkach. Jeśli chcesz zachować style CSS z arkusza stylów CSS, ustaw LoadStylesAndCSSFromMainHtmlDocument = true we właściwościach klasy. Jest to szczególnie przydatne podczas pracy z czcionkami internetowymi i ikonami.

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

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

Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)

Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)

Jak kontrolować marginesy nagłówka/stopki w HTML?

Podobnie jak w przypadku tekstowych nagłówków i stopek, metody AddHtmlHeaders i AddHtmlFooters mają do nich zastosowane zdefiniowane wcześniej marginesy. Aby zastosować niestandardowe marginesy, należy użyć przeciążenia funkcji z określonymi wartościami marginesów. Aby zawrzeć całą treść bez żadnych marginesów, należy ustawić marginesy w funkcji overload na 0. Ten poziom kontroli jest niezbędny podczas tworzenia profesjonalnych dokumentów o określonych wymaganiach dotyczących układu.

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

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

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

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

Czy podczas renderowania mogę dodawać nagłówki/stopki HTML?

Dodawanie nagłówków i stopek można również zrealizować bezpośrednio przez RenderingOptions renderera. Dodaje to nagłówek i stopkę HTML podczas procesu renderowania, co jest bardziej wydajne niż przetwarzanie końcowe. Ta metoda jest szczególnie przydatna podczas generowania plików PDF z plików HTML lub konwersji adresów URL do formatu PDF.

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

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

Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)

Imports IronPdf

Private headerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>"

Private footerHtml As String = "
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>"

' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
	.HtmlFragment = headerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

Private htmlFooter As New HtmlHeaderFooter With {
	.HtmlFragment = footerHtml,
	.LoadStylesAndCSSFromMainHtmlDocument = True
}

' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)

Kiedy należy używać nagłówków/stopek tekstowych, a kiedy HTML?

Przy podejmowaniu decyzji między nagłówkami/stopkami w formacie tekstowym a HTML należy rozważyć związane z tym kompromisy. Jeśli zależy Ci na szybszym renderowaniu plików PDF, wybierz opcję "Nagłówki/stopki tekstowe". Jeśli dostosowywanie i stylizacja są istotne, wybierz nagłówki/stopki HTML. Różnica w czasie renderowania między nagłówkami/stopkami w formacie tekstowym a HTML jest minimalna, gdy nagłówki/stopki HTML zawierają ograniczoną zawartość. Jednak rośnie wraz ze wzrostem rozmiaru i liczby zasobów w nagłówkach/stopkach HTML.

Jakie są konsekwencje dla wydajności?

Nagłówki i stopki tekstu renderują się szybciej, ponieważ nie wymagają analizy HTML ani przetwarzania CSS. Nagłówki/stopki HTML zapewniają większą elastyczność, ale wymagają dodatkowego czasu renderowania proporcjonalnego do ich złożoności. Podczas pracy z dużymi dokumentami lub przetwarzania wsadowego różnica w wydajności staje się bardziej zauważalna. Aby uzyskać optymalną wydajność w scenariuszach wymagających przetwarzania dużych ilości danych, zapoznaj się z naszym przewodnikiem dotyczącym asynchronicznego generowania plików PDF.

Gotowy, aby sprawdzić, co jeszcze możesz zrobić? Zapoznaj się z naszą stroną z samouczkami tutaj: Tworzenie plików PDF

Często Zadawane Pytania

Jak dodac tekstowe naglowki i stopki do PDF w C#?

Za pomoca IronPDF mozesz dodawac tekstowe naglowki i stopki za pomoca metod AddTextHeaders i AddTextFooters. Wystarczy utworzyc instyncje obiektu TextHeaderFooter, dodac pozadany tekst i zastosowac go do twojego PDF-a. To zapewnia prosty sposob na dodanie takich elementow tekstowych jak numeracja stron czy tytuly dokumentow na wszystkich stronach.

Czy moge wlaczyc numeracje stron w moich naglowkach lub stopkach PDF?

Tak, IronPDF wspiera dynamiczna numeracje stron za pomoca specjalnych symboli zastepczych. Mozesz uzyc {page} dla numeru biezacej strony i {total-pages} dla calkowitej liczby stron w twoich obiektach TextHeaderFooter. Na przyklad, ustawienie RightText = 'Strona {page} z {total-pages}' automatycznie wyswietli poprawne numery stron na kazdej stronie.

Czy mozna dodac naglowki i stopki oparte na HTML z CSS stylizacja?

Absolutnie! IronPDF dostarcza metody AddHtmlHeaders i AddHtmlFooters, ktore pozwalaja na dodanie tresci HTML z pelnym wsparciem dla CSS stylizacji. To umożliwia tworzenie zlozonych naglowkow i stopki z formatowanym tekstem, obrazami i dopasowana stylizacja do wytycznych twojej marki.

Jaki jest najwydajniejszy sposob dodawania naglowkow i stopki do PDF-ow?

Najwydajniejszym podejsciem jest dodawanie naglowkow i stopki w trakcie procesu renderowania za pomoca IronPDF's RenderingOptions. Konfigurujac Wlasciwosci TextHeader i TextFooter w ChromePdfRenderer przed renderowaniem, zmniejszasz czas przetwarzania w porownaniu do dodawania ich po utworzeniu PDF-a.

Czy moge dodac rozna tresc do lewej, srodkowej i prawej czesci naglowkow/stopki?

Tak, klasa TextHeaderFooter w IronPDF dostarcza wlasciwosci LeftText, CenterText i RightText, co pozwala na umieszczenie roznej tresci w kazdej czesci. To daje ci elastycznosc w organizowaniu informacji, takich jak daty po lewej, tytuly w srodku i numeracja stron po prawej.

Jak dodac logo firmy do moich naglowkow PDF?

Aby dodac logo firmy do swoich naglowkow PDF, uziel metody AddHtmlHeaders w IronPDF. Mozesz uwzględnić znacznik obrazu w swojej tresci HTML wskazujacy na plik z logo, wraz z dowolnym dodatkowymi stylizacja lub ustawieniem w CSS, aby upewnic sie, ze pojawia sie dokladnie tam, gdzie tego chcesz.

Czy moge wlaczyc daty do moich naglowkow i stopki PDF?

Tak, IronPDF wspiera dynamiczne wstawienie daty za pomoca {date} symbolu zastepczego w obiektach TextHeaderFooter. Gdy uwzgednisz {date} w tekscie naglowka lub stopki, zostanie automatycznie zastepione biezaca data podczas generowania PDF.

How do I detect if a header or footer overlaps existing PDF content?

Pass a ContentOverlapBehavior to the AddHtmlHeaders or AddHtmlFooters overloads, or set RenderingOptions.HeaderFooterOverlapBehavior. Ignore skips the check (default), Warn logs the affected page indexes, and Throw raises an InvalidOperationException before stamping. Detection is report-only and covers text and images only, not vector content such as table borders, and it requires the HtmlHeaderFooter.MaxHeight to be set.

Curtis Chau

Czat z zespołem inżynierów teraz

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,543|Wersja:2026.7właśnie wydany

Pobierz z NuGet

Łączna liczba pobrań: 20,667,543

Zobacz licencje

Jak dodać nagłówki i stopki w PDF za pomocą IronPDF

Zobacz na GitHubie

Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
Wybierz pakiet i zainstaluj

Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

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

Licencje od 749 USD