1. IronPDF
  2. 操作指南
  3. 向 PDF 添加页码
如何使用C#向PDF添加页码

How to Add Page Numbers in a PDF

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

页码是在PDF文档中分配给每个独立页面的连续数字。 页码是文档中导航的最重要组成部分之一。 它们帮助读者定位特定页面并确定他们正在阅读的页面。 此外，页码还可以轻松引用和参考文档中的内容。 使用IronPDF，向您的PDF添加页码是一个简单的过程。

快速入门：轻松向PDF添加页码

使用IronPDF可以轻松地向您的PDF文档添加页码。 只需几行C#代码，您就可以在页眉或页脚中插入动态页码，定制其位置，并指定它们应出现的页面。 无论您处理的是新PDF还是现有PDF，IronPDF都提供了一个简单易用且灵活的解决方案，以增强文档的导航和组织。 按照指南快速在您的项目中实施页码。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    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. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小工作流程（5步）

  1. 从NuGet下载C# PDF库
  2. 加载现有的PDF文档或渲染一个新文档
  3. 在Header和Footer中使用占位符字符串{page}和{total-pages}来插入页码
  4. 将页码应用于特定页面或部分
  5. 查看生成的PDF文档

## 添加页码示例 使用占位符字符串`{page}`和`{total-pages}`，结合**TextHeaderFooter**或**HtmlHeaderFooter**类，您可以添加当前页码和总页数。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs ``` 上面的代码输出的PDF如下所示： 您也可以将页眉和页脚与页码占位符字符串直接添加到**ChromePdfRenderer**的渲染选项中。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs ``` ## 特定页面添加页码示例 使用IronPDF，您可以决定在哪些地方添加页码。 您可以使它们从某个页面或特定的页面组开始，例如在偶数索引页面上。 让我们准备好我们的PDF文档以应用页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs ``` ### 偶数页面索引 在上一个代码示例的基础上，以下代码将页码仅应用于偶数页面索引。 由于我们过滤了偶数页面索引，生成的PDF将仅在奇数页码上应用数字。 页面索引从零开始，而页码从一开始。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs ``` ### 奇数页面索引 专门为奇数索引的页面添加页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs ``` ### 仅最后一页 仅在最后一页添加页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs ``` ### 仅第一页 仅在第一页添加页码。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs ``` ### 跳过第一页 应用页眉时跳过第一页。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs ``` ### 跳过第一页 And Don't Count it 跳过第一页并从第二页开始编号，将其视为第1页。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs ``` 要探索所有元数据选项，请访问[IronPDF Headers and Footers Guide](/how-to/headers-and-footers/#anchor-metadata-to-text-header-footer)。

常见问题解答

如何使用 C# 向 PDF 添加页码？

您可以通过使用 IronPDF 库在 C# 中向 PDF 添加页码。首先，从 NuGet 下载 C# PDF 库。然后，加载现有的 PDF 或创建一个新的 PDF，并在页眉或页脚中使用占位符字符串 {page} 和 {total-pages} 插入页码。最后，保存更新后的 PDF。

我可以自定义 PDF 中页码的位置吗？

是的，使用 IronPDF，您可以自定义 PDF 中页码的位置。您可以选择仅将页码添加到特定页面，例如偶数索引页或奇数索引页，或仅应用到第一页或最后一页。

如何只将页码添加到 PDF 的偶数页？

要使用 IronPDF 仅向 PDF 的偶数页添加页码，请按偶数索引过滤页面，并设置所需的页码占位符的页眉或页脚。然后，页码将应用于偶数索引的页面。

是否可以从 PDF 的第二页开始页码？

是的，使用 IronPDF，您可以跳过第一页，从第二页开始编号。要做到这一点，请将页眉或页脚设置为从第二页开始应用，并使用占位符字符串管理编号顺序。

如何仅向 PDF 的最后一页添加页码？

要使用 IronPDF 仅向 PDF 的最后一页添加页码，您可以专门配置页眉或页脚应用于最后一页。这可以通过引用最后一页索引并设置页码占位符字符串来实现。

使用占位符字符串进行 PDF 页码的好处是什么？

占位符字符串如 {page} 和 {total-pages} 允许动态插入当前页码和总页数。这使得编号管理灵活且高效，尤其是在文档结构发生变化时。IronPDF 利用这些占位符来简化页码过程。

如何在不影响第一页的情况下向 PDF 添加页码？

要使用 IronPDF 在不影响第一页的情况下向 PDF 添加页码，请将页眉或页脚设置为从第二页开始。此方法确保第一页保持无页码，而后续页面则收到页码。

IronPDF 能够处理 HTML 内容和现有 PDF 的页码吗？

是的，IronPDF 可以处理 HTML 内容和现有 PDF 的页码。您可以将 HTML 渲染为 PDF，并使用 IronPdf.ChromePdfRenderer 应用页码，或修改现有的 PDF 文档以在页眉和页脚中添加页码。

IronPDF 在添加页码时是否完全兼容 .NET 10？

是的——IronPDF 与 .NET 10 完全兼容，允许您在 .NET 10 项目中使用页眉或页脚以及占位符字符串{page}和{total-pages}添加页码，就像在早期的 .NET 版本中一样。

Jordi Bardia
Jordi Bardia
  立即与工程团队聊天
软件工程师
Jordi 最擅长 Python、C# 和 C++，当他不在 Iron Software 利用这些技能时，他就在游戏编程。分享产品测试、产品开发和研究的责任，Jordi 在持续的产品改进中增加了巨大的价值。多样的经验使他面临挑战并保持投入，他表示这是在 Iron Software 工作的最喜欢的方面之一。Jordi 在佛罗里达州迈阿密长大，并在佛罗里达大学学习计算机科学和统计学。
审核者
Jeff Fritz
Jeffrey T. Fritz
首席项目经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席项目经理。他是 .NET Conf 虚拟会议系列的执行制片人，并主持“Fritz and Friends”直播节目，每周两次与观众一起谈论技术并编写代码。Jeff 撰写研讨会、演示文稿并计划包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP 峰会在内的最大型微软开发者活动的内容。
准备开始了吗？
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布