## 一、背景与需求

在文档管理场景中，为PDF文件添加页码是一项常见需求。无论是财务报表、项目文档还是合同协议，规范的页码都能显著提升文档的可读性和专业性。手动为每页添加页码不仅效率低下，还容易出错。对于 .NET 开发者而言，利用 C# 实现 PDF 页码的自动化插入，是提升文档处理效率的有效途径。

本文将介绍如何使用 **Free Spire.PDF for .NET** 免费库，通过 C# 码为现有PDF文档批量添加页码。

---

## 二、环境准备

### 2.1 安装方式

Free Spire.PDF for .NET 可通过NuGet直接安装：

```bash
dotnet add package FreeSpire.PDF
```
或在 Visual Studio 的包管理器控制台中执行：

```bash
Install-Package FreeSpire.PDF
```

### 2.2 命名空间引用

代码中需要引入以下命名空间：

```csharp
using Spire.Pdf;
using Spire.Pdf.Graphics;
using Spire.Pdf.AutomaticFields;
using System.Drawing;
```

---

## 三、核心实现

动态字段方式利用 `PdfPageNumberField`、`PdfPageCountField` 和 `PdfCompositeField` 三个类组合实现页码的自动生成与渲染。
- `PdfPageNumberField`：显示当前页码

- `PdfPageCountField`：显示文档总页数

- `PdfCompositeField`：将多个动态字段组合为一个复合字段

以下是完整的实现代码：

```csharp
using Spire.Pdf;
using Spire.Pdf.AutomaticFields;
using Spire.Pdf.Graphics;
using System.Drawing;

namespace AddPageNumbers
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载PDF文档
            PdfDocument pdf = new PdfDocument();
            pdf.LoadFromFile("示例文档.pdf");

            // 2. 创建字体（建议使用系统中存在的通用字体）
            PdfTrueTypeFont font = new PdfTrueTypeFont("宋体", 10f, PdfFontStyle.Regular, true);

            // 3. 创建页码字段和总页数字段
            PdfPageNumberField pageNumber = new PdfPageNumberField();
            PdfPageCountField pageCount = new PdfPageCountField();

            // 4. 组合字段，格式为"第X页，共Y页"（支持中文）
            PdfCompositeField compositeField = new PdfCompositeField(
                font, 
                PdfBrushes.Black, 
                "第 {0} 页 / 共 {1} 页", 
                pageNumber, 
                pageCount);

            // 5. 设置页码位置（基于第一页尺寸，通常各页尺寸一致）
            //    定位到页面底部居中靠左，距左边距72点（1英寸），距底边45点
            float leftMargin = 72f;
            float bottomMargin = 45f;
            SizeF pageSize = pdf.Pages[0].Size;   // 获取基准页面尺寸
            compositeField.Location = new PointF(leftMargin, pageSize.Height - bottomMargin);

            // 6. 遍历每一页，在页面底部绘制页码
            for (int i = 0; i < pdf.Pages.Count; i++)
            {
                PdfPageBase page = pdf.Pages[i];
                // 使用无参 Draw，自动应用 Location
                compositeField.Draw(page.Canvas);
            }

            // 7. 保存文档
            pdf.SaveToFile("添加页码后的文档.pdf");
            pdf.Close();
            pdf.Dispose();
        }
    }
}
```

---

## 四、高级定制

### 4.1 页码格式自定义

通过修改 `PdfCompositeField` 的格式化字符串，可以灵活调整页码的显示格式：

```csharp
// 中文格式
"第 {0} 页 / 共 {1} 页"

// 英文格式
"Page {0} of {1}"

// 简单格式
"{0}/{1}"
```

### 4.2 页码位置控制

页码的位置可通过 `Location` 属性精确控制。

**示例1：底部居中**

```csharp
// 需要先测量文本宽度，再计算居中坐标
string sampleText = "第 999 页 / 共 999 页";  // 最宽情况
SizeF textSize = font.MeasureString(sampleText);
float x = (pageSize.Width - textSize.Width) / 2;
float y = pageSize.Height - bottomMargin;
compositeField.Location = new PointF(x, y);
```

**示例2：底部右侧**

```csharp
float rightMargin = 72f;
string sampleText = "第 999 页 / 共 999 页";
SizeF textSize = font.MeasureString(sampleText);
float x = pageSize.Width - textSize.Width - rightMargin;
float y = pageSize.Height - bottomMargin;
compositeField.Location = new PointF(x, y);
```

**示例3：页眉居中**

```csharp
float topMargin = 30f;
string sampleText = "第 999 页 / 共 999 页";
SizeF textSize = font.MeasureString(sampleText);
float x = (pageSize.Width - textSize.Width) / 2;
float y = topMargin;
compositeField.Location = new PointF(x, y);
```

### 4.3 页码样式调整

字体、颜色、大小等样式均可自定义：

```csharp
// 设置字体为 Arial、12号、粗体
PdfTrueTypeFont font = new PdfTrueTypeFont("Arial", 12f, PdfFontStyle.Bold, true);

// 设置颜色为蓝色
PdfBrush brush = PdfBrushes.Blue;
```

### 4.4 处理不同尺寸的页面

如果PDF中各页面尺寸不一致，应逐页获取尺寸并计算位置：

```csharp
for (int i = 0; i < pdf.Pages.Count; i++)
{
    PdfPageBase page = pdf.Pages[i];
    SizeF pageSize = page.Size;
    // 根据当前页尺寸计算位置
    float x = (pageSize.Width - textWidth) / 2;
    float y = pageSize.Height - bottomMargin;
    compositeField.Location = new PointF(x, y);
    compositeField.Draw(page.Canvas);
}
```

---

## 五、注意事项

**1. 免费版限制**：Free Spire.PDF 社区版对处理页数有一定限制（通常为10页以内），适用于小型文档。

**2. 字体支持**：使用 `PdfTrueTypeFont` 时需要确保指定的字体在系统中可用，否则可能出现渲染异常。

**3. 坐标系统**：页面画布的坐标系原点位于**左上角**，`X`轴向右为正，`Y`轴向下为正。使用 Location 属性时，默认以文本的左上角为定位点。因此，Location.Y 值越大，文本位置越靠下。本文示例中通过 pageSize.Height - bottomMargin 计算底部位置，正是基于这一坐标系。

**4. 文本宽度测量**：当需要居中或右对齐时，使用 `font.MeasureString()` 获取文本宽度，建议以最长的页码格式（如“第 999 页 / 共 999 页”）为基准进行测量，避免因页码位数变化导致位置偏移。

**5. 文档保存**：建议使用 `SaveToFile` 方法保存为新文件，避免覆盖原始文档造成数据丢失。

**6. 资源释放**：处理完成后调用 `Dispose()` 方法释放文档占用的资源，确保内存安全。

---

## 六、总结

通过以上示例，开发者可以用简洁的 C# 代码实现 PDF 文档的批量页码添加。采用 `PdfCompositeField` 动态字段方式，可以灵活定制“第X页，共Y页”等丰富格式，并通过 `Location` 属性精确控制页码位置。该方式稳定可靠，适用于各类文档处理场景。在实际开发中，注意字体选择、坐标计算以及免费版的页数限制，即可快速为PDF文档添加规范的页码，提升文档的专业性和可读性。

在文档管理场景中，为PDF文件添加页码是一项常见需求。无论是财务报表、项目文档还是合同协议，规范的页码都能显著提升文档的可读性和专业性。手动为每页添加页码不仅效率低下，还容易出错。对于 .NET 开发者而言，利用 C# 实现 PDF 页码的自动化插入，是提升文档处理效率的有效途径。

C# 为 PDF 文件批量添加页码的简单实现方法

编程语言

开发工具

后端

学习使用C#和FreeSpire.PDF库为PDF文档自动添加页码，提升文档专业性。包含环境配置、核心代码实现、页码格式与位置自定义方法，以及处理不同页面尺寸的技巧。适用于财务报表、合同等文档处理，提高工作效率。

数据丢失

包管理器

文档处理

代码解释

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

C# 为 PDF 文件批量添加页码的简单实现方法-腾讯云开发者社区-腾讯云

C# 为 PDF 文件批量添加页码的简单实现方法

C# 为 PDF 文件批量添加页码的简单实现方法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐