使用 C# 为 PDF 添加 X/Y 页码

PDF 文档作为信息交流和存储的通用格式，在日常办公和技术文档中扮演着不可或缺的角色。然而，当处理大量 PDF 文档时，手动为每一页添加页码无疑是一项繁琐且耗时的工作。为了提升效率和文档的专业性，自动化地为 PDF 文档添加页码变得尤为重要。

本文将引导您使用 C# 编程语言，结合强大的第三方库 Spire.PDF for .NET，轻松实现在 PDF 文档的每一页底部添加"第 X 页 / 共 Y 页"格式的页码。Spire.PDF for .NET 以其丰富的功能、易用性和高效性，成为 .NET 开发者处理 PDF 文档的理想选择。通过本文的详细教程，您将掌握如何自动化这一常见需求，从而优化您的文档处理流程。

Spire.PDF for .NET 简介与环境准备

Spire.PDF for .NET 是一个专业的 .NET PDF 组件，它允许开发者在 .NET 应用程序中创建、读取、编辑、转换和打印 PDF 文档，而无需安装 Adobe Acrobat。其主要特点包括：

功能全面： 支持文本、图片、表格、图表、书签、附件、水印、页眉页脚等各种 PDF 元素的操作。
性能优异： 处理大型 PDF 文档时表现出色。
易于集成： 提供了清晰的 API 接口，方便开发者快速上手。
独立性强： 不依赖于 Adobe Acrobat 或其他第三方软件。

如何安装 Spire.PDF for .NET

在您的 .NET 项目中集成 Spire.PDF for .NET 非常简单，只需通过 NuGet 包管理器进行安装。

通过 NuGet 包管理器控制台安装：

在 Visual Studio 中，打开"工具"->"NuGet 包管理器"->"包管理器控制台"，然后输入以下命令：
bash 复制代码
```
Install-Package Spire.PDF
```
通过 NuGet 包管理器 UI 安装：

在 Visual Studio 中，右键点击您的项目，选择"管理 NuGet 包..."，然后在"浏览"选项卡中搜索"Spire.PDF"，点击安装即可。

安装完成后，Spire.PDF for .NET 的引用将自动添加到您的项目中，您就可以开始使用它的功能了。

核心代码实现：添加"第 X 页 / 共 Y 页"页码

本节将详细介绍如何使用 C# 和 Spire.PDF for .NET 在 PDF 文档的每一页底部居中添加"第 X 页 / 共 Y 页"格式的页码。

实现逻辑概述

加载文档： 使用 PdfDocument 类加载目标 PDF 文档。
获取总页数： 获取文档的总页数，用于构建页码字符串中的"共 Y 页"。
遍历页面： 迭代文档中的每一页。
创建页码文本： 为当前页构建"第 X 页 / 共 Y 页"格式的字符串。
设置样式： 定义页码文本的字体、大小、颜色和对齐方式。
计算位置： 根据页面尺寸和页边距，计算页码文本的绘制位置，使其在底部居中。
绘制页码： 将页码文本绘制到当前页。
保存文档： 将修改后的文档保存到新的 PDF 文件中。

完整的 C# 代码示例

cs 复制代码

using Spire.Pdf;
using Spire.Pdf.AutomaticFields;
using Spire.Pdf.Graphics;
using System.Drawing;
using Spire.Pdf.License;

namespace AddPageNumbersToCenter
{
    class Program
    {
        static void Main(string[] args)
        {
            // 创建一个 PdfDocument 对象
            PdfDocument doc = new PdfDocument();

            // 加载 PDF 文件
            doc.LoadFromFile("C:\\Users\\Administrator\\Desktop\\Input.pdf");

            // 创建字体、画刷和笔，设置页码外观
            PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("宋体", 10f, FontStyle.Regular), true);
            PdfBrush brush = PdfBrushes.Black;
            PdfPen pen = new PdfPen(brush, 1.0f);

            // 创建 PdfPageNumberField 和 PdfPageCountField 对象
            PdfPageNumberField pageNumberField = new PdfPageNumberField();
            PdfPageCountField pageCountField = new PdfPageCountField();

            // 创建 PdfCompositeField 对象，组合页码和总页数
            PdfCompositeField compositeField = new PdfCompositeField(font, brush, "第 {0} 页 / 共 {1} 页", pageNumberField, pageCountField);

            // 遍历文档中的每一页
            for (int i = 0; i < doc.Pages.Count; i++)
            {
                // 获取当前页
                PdfPageBase page = doc.Pages[i];
                // 获取页面尺寸
                SizeF pageSize = page.Size;

                // 在指定位置绘制线条
                page.Canvas.DrawLine(pen, 72, pageSize.Height - 50, pageSize.Width - 72, pageSize.Height - 50);

                // 测量"第 X 页 / 共 Y 页"的宽度
                SizeF pageNumberSize = font.MeasureString(string.Format("第 {0} 页 / 共 {1} 页", i + 1, doc.Pages.Count));

                // 设置组合字段的位置，使其居中
                compositeField.Location = new PointF((pageSize.Width - pageNumberSize.Width) / 2, pageSize.Height - 45);
                // 在页面上绘制组合字段
                compositeField.Draw(page.Canvas);
            }

            // 将结果保存为一个新的 PDF 文件
            doc.SaveToFile("AddPageNumbersToCenter.pdf");
            // 释放资源
            doc.Dispose();
        }
    }
}

关键代码行解释：

doc.LoadFromFile("C:\\Users\\Administrator\\Desktop\\Terms of service.pdf");：加载指定的 PDF 文件。
doc.Pages.Count;：获取 PDF 文档的页面总数。
PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("宋体", 10f, FontStyle.Regular), true);：创建一个宋体字体，大小为 12pt。
PdfBrush brush = PdfBrushes.Black;：定义页码文本的颜色为黑色。
PdfCompositeField compositeField = new PdfCompositeField(font, brush, "第 {0} 页 / 共 {1} 页", pageNumberField, pageCountField);：创建一个组合字段，格式为"第 X 页 / 共 Y 页"。
compositeField.Location = new PointF((pageSize.Width - pageNumberSize.Width) / 2, pageSize.Height - 45);：计算页码绘制的位置，使其居中。
compositeField.Draw(page.Canvas);：将在当前页上绘制组合字段。
doc.SaveToFile("AddPageNumbersToCenter.pdf");：将带有页码的新 PDF 文档保存为 AddPageNumbersToCenter.pdf。

进一步的自定义与考量

Spire.PDF for .NET 提供了极高的灵活性，您可以根据具体需求对页码进行更细致的自定义：

调整页码位置。
字体样式与颜色。
页码格式。
处理不同尺寸页面或特殊布局。
水印效果。

Spire.PDF for .NET 的强大之处在于其丰富的 API，允许开发者精细控制 PDF 文档的每一个细节。

总结

通过本文的教程，您已经掌握了如何使用 C# 和 Spire.PDF for .NET 库，自动化地为 PDF 文档添加"第 X 页 / 共 Y 页"格式的页码。这不仅极大地简化了原本繁琐的手动操作，也提高了文档的专业性和可读性。我们鼓励您进一步探索 Spire.PDF for .NET 的其他功能，从而为您的应用程序带来更大的价值和效率提升。