C#使用Spire.Doc设置Word页眉页脚的详细教程_Asp.net

在日常的办公自动化中，word 文档的页眉页脚经常被用来放置公司 logo、标题、页码等信息。传统的手工操作既繁琐，又容易出错，尤其是需要批量生成大量文档时更是如此。借助 c# 与强大的文档处理库 spire.doc，我们可以在代码层面灵活地对页眉页脚进行增删改查，从而实现自动化、统一化的文档排版。

1. 为什么选择 spire.doc？

spire.doc 是一款纯 .net 实现的 word 操作组件，支持 .doc/.docx 格式的读取、编辑、保存。相比于 microsoft.office.interop，它不依赖 office 安装，运行时占用资源更少，且提供了丰富的 api 来直接操作 headerfooter、section、paragraph、docpicture 等对象，非常适合服务器端或后台服务使用。

2. 基础：向文档添加页眉页脚

下面的示例演示了如何在一个 section 中创建页眉页脚，并向其中插入图片、文字以及页码。

private void insertheaderandfooter(section section)
{
    // 获取页眉、页脚对象
    headerfooter header = section.headersfooters.header;
    headerfooter footer = section.headersfooters.footer;

    // ---------- 页眉 ----------
    paragraph headerparagraph = header.addparagraph();
    docpicture headerpic = headerparagraph.appendpicture(image.fromfile("header.png"));
    textrange headertext = headerparagraph.appendtext("demo of spire.doc");
    headertext.characterformat.fontname = "arial";
    headertext.characterformat.fontsize = 10;
    headertext.characterformat.italic = true;
    headerparagraph.format.horizontalalignment = horizontalalignment.right;
    headerparagraph.format.borders.bottom.bordertype = borderstyle.single;
    headerparagraph.format.borders.bottom.space = 0.05f;
    headerpic.textwrappingstyle = textwrappingstyle.behind;
    headerpic.horizontalorigin = horizontalorigin.page;
    headerpic.horizontalalignment = shapehorizontalalignment.left;
    headerpic.verticalorigin = verticalorigin.page;
    headerpic.verticalalignment = shapeverticalalignment.top;

    // ---------- 页脚 ----------
    paragraph footerparagraph = footer.addparagraph();
    docpicture footerpic = footerparagraph.appendpicture(image.fromfile("footer.png"));
    footerpic.textwrappingstyle = textwrappingstyle.behind;
    footerpic.horizontalorigin = horizontalorigin.page;
    footerpic.horizontalalignment = shapehorizontalalignment.left;
    footerpic.verticalorigin = verticalorigin.page;
    footerpic.verticalalignment = shapeverticalalignment.bottom;

    // 添加页码字段
    footerparagraph.appendfield("page number", fieldtype.fieldpage);
    footerparagraph.appendtext(" of ");
    footerparagraph.appendfield("total pages", fieldtype.fieldnumpages);
    footerparagraph.format.horizontalalignment = horizontalalignment.right;
    footerparagraph.format.borders.top.bordertype = borderstyle.single;
    footerparagraph.format.borders.top.space = 0.05f;
}

图片定位：通过 horizontalorigin/verticalorigin 与 shapehorizontalalignment/shapeverticalalignment 可以实现图片相对页面的绝对定位，常用于 logo 或公司标识的固定展示。
页码：fieldtype.fieldpage 与 fieldtype.fieldnumpages 组合即可得到“第 x 页 / 共 y 页”的效果，且会随文档页数自动更新。

3. 只在首页显示特殊页眉

有时公司报告要求首页使用独立的标题页眉，而后续页面使用统一的页眉。spire.doc 通过 pagesetup.differentfirstpageheaderfooter 来实现。

// 让所有节的首页使用独立的页眉/页脚
foreach (section sec in doc2.sections)
{
    sec.pagesetup.differentfirstpageheaderfooter = true;
}

// 将源文档的普通页眉复制到目标文档的首页页眉
headerfooter srcheader = doc1.sections[0].headersfooters.header;
headerfooter firstpageheader = doc2.sections[0].headersfooters.firstpageheader;
firstpageheader.paragraphs.clear();
foreach (documentobject obj in srcheader.childobjects)
{
    firstpageheader.childobjects.add(obj.clone());
}

关键点在于：

开启差异页眉：differentfirstpageheaderfooter = true 后，firstpageheader 与普通 header 会被视为两个独立对象。
对象克隆：直接复制 childobjects 并使用 clone()，可以保证图形、文本、字段等属性完整迁移。

4. 跨文档复制页眉页脚

在批量生成报告时，往往需要把统一的页眉页脚模板复制到每一个新文档。下面的代码展示了如何一次性将源文档的页眉复制到目标文档的所有节。

headerfooter srcheader = doc1.sections[0].headersfooters.header;
foreach (section sec in doc2.sections)
{
    foreach (documentobject obj in srcheader.childobjects)
    {
        sec.headersfooters.header.childobjects.add(obj.clone());
    }
}

小技巧：如果目标文档已经包含内容，建议先 clear() 目标节的页眉，以免出现重复元素。

5. 调整页眉页脚与正文的距离

不同的排版需求可能要求页眉离页面顶部更近或更远。spire.doc 提供了 headerdistance 与 footerdistance 两个属性来控制这个间距（单位为磅，1 英寸≈72 磅）。

section sec = doc.sections[0];
sec.pagesetup.headerdistance = 100; // 约 1.39 英寸
sec.pagesetup.footerdistance = 100;

合理的距离可以避免页眉与正文重叠，提升文档的可读性。

6. 使用 documentnavigator 定位到页眉页脚（进阶）

documentnavigator 是 spire.doc 中的光标对象，适合在遍历文档树时临时跳转到页眉或页脚。

documentnavigator nav = doc.navigator;
nav.movetoheaderfooter(headerfootertype.header); // 移动到当前节的页眉
// 此时可以对 nav.currentparagraph 进行编辑

该方法在需要 在文档遍历过程中 动态修改页眉/页脚时尤为便利。

7. 实战建议

场景	推荐实现方式
统一模板	在代码启动时加载一次模板文档，仅复制 `headerfooter`，避免重复读取磁盘。
不同章节不同页眉	为每个章节创建独立的 `section`，并分别设置 `headersfooters`。
自动分页	使用 `section.pagesetup.differentfirstpageheaderfooter` 配合 `fieldpage`，无需手动计算页码。
性能优化	大批量生成时，使用 `doc.savetostream()` 并一次性写入磁盘，可显著提升 i/o 效率。