引言
页眉常被视为文档的边角元素，但实际上是文档的门面担当。一份PDF文件是否添加了页眉，阅读体验截然不同——页眉如同文档的身份证，将标题、作者、日期、页码等关键信息集中呈现，读者扫一眼即可识别内容，翻页查找也更加便捷。尤其是在企业文档中，嵌入Logo或品牌名称，能够显著提升专业感与辨识度。
接下来直接进入实操环节：如何使用C#和VB.NET为现有的PDF文档批量添加页眉。
环境准备
动手前先备好开发工具箱。需将PDF组件包中的DLL文件添加到.NET项目引用中，可通过官网下载或通过NuGet一键安装完成。
PM> Install-Package Spire.PDF
背景知识
首先了解一个基础概念：PDF页面的坐标系原点位于左上角，这一点至关重要——X轴向右、Y轴向下延伸，后续所有绘制操作均基于此逻辑。所谓添加页眉，本质上是在页面顶部空白区域精确定位并插入文本、图片、自动字段或图形元素。听起来复杂，分解开来不过是几个关键步骤。
使用 C# 和 VB.NET 为现有 PDF 文档添加页眉
市面常见的PDF处理库大多提供在页面上绘制文本、图片和图形的能力。利用这些功能，便可在页面顶部组合出标题、公司Logo、分隔线等页眉元素。尤其值得关注的是自动字段，它能动态显示页码、创建日期等信息，页眉内容随文档变化自动更新，无需手动调整。
下面将整个流程拆解，具体操作步骤如下：
- 首先创建PDF文档对象，打好基础。
- 加载已有的PDF文档。
- 准备字体、画刷和画线对象，这些是绘图的核心工具。
- 在页面顶部空白区域绘制文本。
- 在文本下方绘制一条分隔线，从视觉上与正文区分开。
- 加载本地图片（例如Logo）。
- 在页面顶部对应位置插入图片。
- 创建日期字段，用于显示文档创建时间等动态信息。
- 将日期信息绘制到页面上。
- 最后保存为新的PDF文件。
完成上述步骤，自定义页眉便大功告成，动态信息会根据文档实际情况自动填充，可读性与专业性同时拉满。
完整示例代码如下：
using Spire.Pdf;
using Spire.Pdf.AutomaticFields;
using Spire.Pdf.Graphics;
using System.Drawing;
namespace AddHeaderToExistingPdf
{
class Program
{
static void Main(string[] args)
{
//创建 PdfDocument 对象
PdfDocument doc = new PdfDocument();
//加载 PDF 文件
doc.LoadFromFile("C:\Users\Administrator\Desktop\TargetMarket.pdf");
//加载用于页眉的图片
PdfImage headerImage = PdfImage.FromFile("C:\Users\Administrator\Desktop\logo.png");
//获取图片宽度（像素）
float width = headerImage.Width;
//将像素转换为点
PdfUnitConvertor unitCvtr = new PdfUnitConvertor();
float pointWidth = unitCvtr.ConvertUnits(width, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point);
//指定页眉文本
string headerText = "E-iceblue Technwww.e-iceblue.com";
//创建 TrueType 字体
PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Times New Roman", 12f, FontStyle.Bold), true);
//创建画刷
PdfBrush brush = PdfBrushes.Purple;
//创建画笔
PdfPen pen = new PdfPen(brush, 1.0f);
//创建文档创建日期字段
PdfCreationDateField creationDateField = new PdfCreationDateField(font, brush);
creationDateField.DateFormatString = "yyyy-MM-dd";
//创建复合字段，将静态文本与日期字段组合在一起
PdfCompositeField compositeField = new PdfCompositeField(font, brush, "creation time: {0}", creationDateField);
compositeField.Location = new Point(55, 48);
//遍历文档中的所有页面
for (int i = 0; i < doc.Pages.Count; i++)
{
//获取当前页面
PdfPageBase page = doc.Pages[i];
//在顶部空白区域绘制图片
page.Canvas.DrawImage(headerImage, page.ActualSize.Width - pointWidth - 55, 20);
//在顶部空白区域绘制文本
page.Canvas.DrawString(headerText, font, brush, 55, 20);
//在顶部空白区域绘制分隔线
page.Canvas.DrawLine(pen, new PointF(55, 70), new PointF(page.ActualSize.Width - 55, 70));
//在顶部空白区域绘制复合字段
compositeField.Draw(page.Canvas);
}
//保存文件
doc.Sa veToFile("AddHeader.pdf");
doc.Dispose();
}
}
}
总结
简要总结：通过C#和VB.NET为现有PDF添加页眉，核心思路是在页面顶部空白区域，利用绘图功能将文本、图片、分隔线及动态日期等内容排布妥当。借助PDF处理组件提供的绘图与自动字段能力，开发者可灵活定制页眉样式，并批量应用到文档的所有页面。无论是企业Logo、文档标题、创建日期还是页码，均可通过代码自动完成，既省时省力，又让文档呈现得更加规整、专业。
