使用 C## 和 IronPDF 在 PDF 中添加页眉和页脚

Updated: 2026年6月3日

IronPDF使您可以使用类似AddHtmlFooters用于基于HTML的内容，全面支持CSS样式。这一强大的功能对于创建具有一致品牌、页码和文档元数据的专业 PDF 至关重要。

需要在PDF文档的每页顶部或底部包含页码、公司标志或日期吗？ IronPDF 可让您轻松地在 C# 项目中为 PDF 应用页眉和页脚。无论您是在生成报告、发票还是任何商业文档，页眉和页脚都是至关重要的导航和识别元素，可提高文档的可用性。

快速入门：使用 C# 为 PDF 添加页眉和页脚

使用IronPDF在C#中轻松向您的PDF文档添加页眉和页脚。本指南演示了如何在几秒钟内应用带有页码和自定义文本的基于文本的页眉和页脚。使用AddTextFooters方法快速增强PDF呈现。通过最少的代码保存更新后的PDF，确保您的文档具有专业的外观。

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

2复制并运行这段代码。

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

3部署到您的生产环境中进行测试

通过免费试用立即在您的项目中开始使用IronPDF

最小工作流程（5 个步骤）

下载 C# 库以添加页眉和页脚。
加载现有的PDF或渲染一个新PDF
使用 AddTextHeaders 和 AddTextFooters 方法添加文本页眉和页脚
使用 AddHtmlHeaders 和 AddHtmlFooters 方法添加 HTML 页眉和页脚
通过配置 RenderingOptions 在呈现时添加页眉和页脚

如何添加文本页眉/页脚？

要创建仅包含文本的页眉/页脚，请实例化TextHeaderFooter对象，添加您想要的文本，并将对象添加到您的PDF中。 TextHeaderFooter类提供了一种简单的方法来跨文档的所有页面添加一致的文本元素。这种方法尤其适用于不需要复杂格式或样式的简单页眉和页脚。

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

如何在呈现过程中添加页眉/页脚？

或者，可以直接通过渲染器的RenderingOptions直接添加页眉/页脚。这将在渲染过程中添加文本页眉和页脚，这比在创建 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");

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

如何自定义文本和分隔符属性？

在TextHeaderFooter类中，您可以设置左、中、右位置的文本。此外，您可以自定义文本的字体类型和大小，并通过配置相关属性来添加具有自定义颜色的分隔符。通过这些定制选项，您可以创建与企业品牌或文档风格指南相匹配的页眉和页脚。分隔线功能特别适用于在页眉/页脚和主要内容之间创建视觉分隔。

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
}

自定义文本标题看起来像什么？

默认情况下哪些字体可用？

您可以在IronPDF API参考中查看默认可用的字体类型。 IronPDF 支持多种标准字体，包括 Arial、Times New Roman、Helvetica、Courier 及其变体。如果您需要自定义字体，请了解有关在 IronPDF 中管理字体的更多信息。

如何为文本页眉/页脚设置页边距？

默认情况下，IronPDF 中的文本页眉和页脚带有预定义的页边距。如果您希望文本页眉在PDF文档的整个宽度上展开，请指定边距值为0。这可以通过直接在RenderingOptions实现。了解页边距控制对于实现完美像素布局至关重要，尤其是在使用自定义纸张尺寸时。

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

如何通过呈现选项应用页边距？

如果在RenderingOptions中添加边距值，这些边距也适用于页眉和页脚。这种方法提供了一种集中管理整个文档页边距的方法，包括页眉、页脚和主要内容。有关更高级的页边距自定义，请查看我们的自定义页边距设置指南。

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

为什么我要避免`UseMarginsOnHeaderAndFooter`?

RenderingOptions上不适合此用例。它将相同的边距值应用于页眉、页脚和正文内容，这会导致页眉与文档正文重叠。此属性主要用于通过AddTextHeadersAndFooters方法将页眉和页脚应用于现有PDF。为了更好地控制布局，可以考虑使用分页符来管理内容流。

什么是动态边距大小？

当不同文件的页眉内容不同时，静态页边距就成了问题。不仅需要调整页眉和页脚的边距，还需要调整主 HTML 边距，以适应不同的页眉和页脚尺寸。因此，我们实施了动态页边距大小功能，页眉和页脚的高度将根据内容动态调整，而主 HTML 将相应地重新定位。该功能在使用响应式 CSS 布局时尤其有用。使用下面的代码试用此功能：

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

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

如何为文本页眉/页脚添加元数据？

通过在文本中加入占位符字符串，您可以轻松添加页码、日期和 PDF 标题等元数据。这些占位符会在 PDF 呈现时自动替换为相应的值。该功能对于创建根据文档属性自动更新的动态页眉和页脚至关重要。以下是所有可用的元数据选项：

{page}：当前页码。
{total-pages}：总页数。
{url}：生成PDF文档的网址。
{date}：当前日期。
{time}：当前时间。
title标签中指定的HTML标题。
{pdf-title}：在PDF元数据中指定的PDF标题。

哪些占位符最常用？

要了解有关{total-pages}的更多信息，请访问IronPDF页码指南。这些占位符是最常用的，因为它们提供了重要的导航信息。日期和时间占位符对于需要跟踪时间戳的文档（如报告或发票）特别有用。

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

如何添加 HTML 页眉/页脚？

您可以通过利用HTML和CSS进一步自定义页眉/页脚。要创建HTML页眉/页脚，请使用HtmlHeaderFooter类。这种方法具有最大的灵活性，允许您在页眉和页脚中包含图片、复杂布局和样式内容。如果您想保留样式表的CSS样式，在类属性中设置LoadStylesAndCSSFromMainHtmlDocument = true。这在使用网络字体和图标时尤其有用。

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)

如何控制 HTML 页眉/页脚页边距？

类似于文本页眉和页脚，AddHtmlFooters方法应用了预定义边距。要应用自定义边距，请使用带有指定边距值的函数重载。要跨整个内容而不留任何边距，可将重载函数中的边距设置为 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)

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

我能否在呈现过程中添加 HTML 页眉/页脚？

也可以通过渲染器的RenderingOptions直接添加页眉和页脚。在渲染过程中添加 HTML 页眉和页脚，这比后期处理更有效率。这种方法在从 HTML 文件生成 PDF 或将 URL 转换为 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)

何时应使用文本与 HTML 页眉/页脚？

在决定使用文本还是 HTML 页眉/页脚时，请考虑权衡利弊。如果您优先考虑更快的PDF渲染，请选择文本页眉/页脚。如果定制性和样式设计至关重要，请选择 HTML 页眉/页脚。当 HTML 页眉/页脚包含的内容有限时，文本页眉/页脚与 HTML 页眉/页脚的渲染时间差异很小。然而，随着 HTML 页眉/页脚中资产大小和数量的增加，翻译难度也会增加。

对性能有何影响？

文本页眉/页脚的呈现速度更快，因为它们不需要 HTML 解析和 CSS 处理。 HTML 页眉/页脚提供了更大的灵活性，但需要额外的渲染时间，这与其复杂程度成正比。在处理大型文档或批处理时，性能差异会变得更加明显。要在大容量场景中获得最佳性能，请考虑我们的异步 PDF 生成指南。

准备好看看您还能做些什么吗？点击此处查看我们的教程页面：创建 PDF

常见问题解答

如何用 C# 在 PDF 中添加文本页眉和页脚？

using IronPDF，您可以使用 AddTextHeaders 和 AddTextFooters 方法添加文本页眉和页脚。只需实例化一个 TextHeaderFooter 对象，添加所需的文本，并将其应用到 PDF 中即可。这为在所有页面中添加一致的文本元素（如页码或文档标题）提供了一种直接的方法。

能否在 PDF 页眉或页脚中包含页码？

是的，IronPDF 支持使用特殊占位符进行动态页码编号。您可以在 TextHeaderFooter 对象中使用 {page} 表示当前页码，使用 {total-pages} 表示总页数。例如，设置 RightText = "Page {page} of {total-pages}" 将自动在每一页上显示正确的页码。

是否可以使用 CSS 样式添加基于 HTML 的页眉和页脚？

当然可以！IronPDF 提供 AddHtmlHeaders 和 AddHtmlFooters 方法，允许您添加 HTML 内容，并支持完整的 CSS 样式。这使您能够创建带有格式化文本、图像和自定义样式的复杂页眉和页脚，以符合您的品牌准则。

为 PDF 添加页眉和页脚的最有效方法是什么？

最有效的方法是在渲染过程中使用 IronPDF 的 RenderingOptions 添加页眉和页脚。通过在渲染前配置 ChromePdfRenderer 中的 TextHeader 和 TextFooter 属性，与在创建 PDF 后添加相比，可以减少处理时间。

能否在页眉/页脚的左、中、右三部分添加不同的内容？

是的，IronPDF 中的 TextHeaderFooter 类提供了 LeftText、CenterText 和 RightText 属性，允许您在每个部分放置不同的内容。这样，您就可以灵活地组织信息，如日期放在左边，标题放在中间，页码放在右边。

如何在 PDF 标题中添加公司徽标？

要在 PDF 标题中添加公司徽标，请使用 IronPDF 中的 AddHtmlHeaders 方法。您可以在 HTML 内容中包含指向徽标文件的图片标签，并使用 CSS 进行额外的样式或定位，以确保徽标出现在您想要的位置。

能否在 PDF 页眉和页脚中包含日期？

是的，IronPDF 支持使用 TextHeaderFooter 对象中的 {date} 占位符动态插入日期。当您在页眉或页脚文本中包含 {date} 时，它将在 PDF 生成时自动替换为当前日期。

How do I include metadata like page numbers and dates in headers and footers?

IronPDF supports metadata placeholders such as `{page}`, `{total-pages}`, `{date}`, and `{time}` in text headers and footers, which dynamically resolve to present values during PDF rendering.

What is Dynamic Margin Sizing in IronPDF?

Dynamic Margin Sizing in IronPDF automatically adjusts the height of the headers and footers based on the content. This feature helps accommodate variant header/footer content and ensures smooth integration with the main document body.

Which fonts are supported by default for PDF headers and footers in IronPDF?

IronPDF supports a wide range of standard fonts like Arial, Times New Roman, and Helvetica by default. To see the complete list, refer to the IronPDF API Reference for available font types.