标签 PDF 下的文章

在企业日常办公和文档管理中，PDF 已经成为最常用的电子文档格式。无论是财务报表、项目计划，还是合同协议，PDF 都能保证内容在不同平台下的统一显示。然而，当文档页数增加时，页码的缺失或混乱会影响文档的可读性和专业性。

手动为每页添加页码不仅耗时，而且容易出错。对于开发者来说，利用 C# 可以在 .NET 项目中实现自动化页码插入，从而显著提高工作效率，同时保证页码的准确性和格式统一。本文将带你从基础操作到高级定制，完整掌握 PDF 页码自动化的方法。

本文所使用的方法需要用到Free Spire.PDF for .NET，可通过 NuGet 安装：dotnet add package FreeSpire.PDF。

2. 加载 PDF 并获取页面信息

在插入页码之前，需要先加载已有的 PDF 文档，并获取页面数量：

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

string inputFile = "ExistingDocument.pdf";
string outputFile = "DocumentWithPageNumbers.pdf";

// 加载 PDF 文档
PdfDocument doc = new PdfDocument();
doc.LoadFromFile(inputFile);

// 获取总页数
int pageCount = doc.Pages.Count;

在这个阶段，我们已经能够访问文档的每一页，为后续插入页码做准备。

3. 基础页码插入

最简单的页码样式是“第 X 页”，插入到页面底部居中：

for (int i = 0; i < pageCount; i++)
{
    PdfPageBase page = doc.Pages[i];

    PdfFont font = new PdfTrueTypeFont(new Font("宋体", 10f));
    PdfBrush brush = PdfBrushes.Black;

    string pageNumberText = $"第{i + 1}页";

    SizeF textSize = font.MeasureString(pageNumberText);
    float x = (page.Canvas.ClientSize.Width - textSize.Width) / 2;
    float y = page.Canvas.ClientSize.Height - textSize.Height - 10;

    page.Canvas.DrawString(pageNumberText, font, brush, x, y);
}

关键点解析：

  • PdfTrueTypeFont 用于设置字体类型和大小
  • MeasureString 用于计算文本宽度，以便实现居中对齐
  • 坐标 (x, y) 控制页码在页面上的精确位置

4. 保存文档

完成页码插入后，记得保存文件并释放资源：

doc.SaveToFile(outputFile);
doc.Close();

经过以上步骤，已有 PDF 文档就成功生成了专业的页码，无需手动操作 PDF 文档。

以下是生成的 PDF 页码效果预览：

C#生成PDF页码

5 页码高级应用与优化策略

自定义页码格式

企业文档通常要求显示“第 X 页，共 Y 页”，或者英文的“Page X of Y”。只需在字符串中格式化即可：

string pageNumberText = $"第{i + 1}页，共{pageCount}页";
// 或者英文格式
// string pageNumberText = $"Page {i + 1} of {pageCount}";

这样可以保证文档在打印或归档时，页码信息清晰且专业。

灵活控制页码位置

页码不仅可以放在底部居中，还可以放在页脚左侧、右侧，甚至页眉区域。通过调整 X、Y 坐标即可实现不同布局：

// 页脚右侧
float xRight = page.Canvas.ClientSize.Width - textSize.Width - 20;
float yBottom = page.Canvas.ClientSize.Height - textSize.Height - 20;
page.Canvas.DrawString(pageNumberText, font, brush, xRight, yBottom);

// 页眉居中
float xTop = (page.Canvas.ClientSize.Width - textSize.Width) / 2;
float yTop = 10;
page.Canvas.DrawString(pageNumberText, font, brush, xTop, yTop);

排除首页或指定页开始

在报告或合同中，封面页通常不显示页码，或页码从第二页开始：

for (int i = 0; i < pageCount; i++)
{
    if (i == 0) continue; // 跳过首页

    PdfPageBase page = doc.Pages[i];
    string pageNumberText = $"第{i}页，共{pageCount - 1}页";
    SizeF textSize = font.MeasureString(pageNumberText);
    float x = (page.Canvas.ClientSize.Width - textSize.Width) / 2;
    float y = page.Canvas.ClientSize.Height - textSize.Height - 15;

    page.Canvas.DrawString(pageNumberText, font, brush, x, y);
}

这样可以灵活应对各种文档排版需求。

更多页码样式设置

页码的字体、字号、颜色可以根据企业品牌或文档风格进行自定义：

PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Arial", 12f, FontStyle.Bold | FontStyle.Italic));
PdfBrush brush = new PdfSolidBrush(Color.DarkBlue);

结合坐标计算，可以在页面左、中、右随意放置页码，同时保证样式统一。

总结

通过本文的示例，C# 开发者可以轻松为已有 PDF 文档自动添加页码，无需手动操作。代码不仅适用于单页文档，也能处理多页 PDF，并提供了页码样式和位置的灵活控制。这种方法极大提升了办公效率，保证了文档的专业性和规范性，同时也为批量文档处理提供了可靠的技术方案。掌握这一技巧，你可以在财务报表、项目文档、合同协议等各类 PDF 文件中快速生成标准化页码，使文档既清晰又美观。

更多 PDF 文档操作技巧，请前往 Spire.PDF 文档中心查看。