用C#和VB.NET为PDF文档添加页眉

PDF页眉添加：引言与概述

页眉看似是文档边角料，实则是门面担当。一份PDF文档，有无页眉，阅读体验截然不同——页眉如同文档的身份证，标题、作者、日期、页码等关键信息置于顶部，读者扫一眼便知文档内容，翻页查找信息也更加便捷。企业文档中若印上公司Logo或品牌名称，专业感与辨识度会显著提升。

本文将直接讲解如何使用C#和VB.NET为现有PDF文档批量添加页眉，帮助开发者快速实现文档标准化处理。

环境准备

动手之前需备齐工具箱。需要将PDF组件包中的DLL文件添加到.NET项目引用中，可通过官网下载或通过NuGet一键安装。

PM> Install-Package Spire.PDF

PDF坐标系与页眉绘制基础

先了解一个基础知识点。PDF页面坐标系的原点位于左上角——X轴向右延伸、Y轴向下延伸，所有绘制操作均基于此逻辑。添加页眉，本质上就是在页面顶部空白区域精确定位并插入文本、图片、自动字段或图形元素。流程虽看似复杂，拆解后仅需几个步骤即可完成。

使用C#和VB.NET为现有PDF文档添加页眉的完整步骤

市面上常见的PDF处理库大多提供在页面上绘制文本、图片和图形的功能。利用这些能力，可以在页面顶部组合出标题、公司Logo、分隔线等页眉元素。特别值得一提的是自动字段，它可以动态显示页码、创建日期等信息，页眉内容随文档变化自动更新，无需手动调整。

下面将整个流程拆解，展示具体操作：

1. 创建PDF文档对象，奠定基础。
2. 加载已有的PDF文档。
3. 准备字体、画刷和画线对象，这些是绘图的核心工具。
4. 在页面顶部空白区域绘制文本。
5. 在文本下方绘制分隔线，与正文形成视觉区分。
6. 加载本地图片（如Logo）。
7. 在页面顶部对应位置插入图片。
8. 创建日期字段，用于显示文档创建时间等动态信息。
9. 将日期信息绘制到页面上。
10. 保存为新的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、文档标题、创建日期还是页码，均可通过代码自动完成，既节省时间与人力，又能让文档更加规整和专业。