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

更新时间：2026年03月03日 10:01:54 作者：缺点内向

在日常的办公自动化中,Word 文档的页眉页脚经常被用来放置公司 LOGO、标题、页码等信息,本文给大家介绍了如何借助 C# 与强大的文档处理库 Spire.Doc,让我们可以在代码层面灵活地对页眉页脚进行增删改查,需要的朋友可以参考下

在日常的办公自动化中，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 效率。

8. 小结

通过 Spire.Doc，C# 开发者可以在几行代码内完成 Word 文档页眉页脚的创建、复制、定制和排版。无论是公司报告、合同模板，还是批量生成的发票，都能实现统一风格、自动分页、灵活布局的目标。掌握上述核心 API 后，你就可以把繁琐的手工排版工作交给代码完成，让文档生成变得更加高效、可靠。

延伸阅读：如果你需要更高级的功能（如在页眉中嵌入动态表格、条件显示），可以进一步探索 HeaderFooter 的 ChildObjects 结构，结合 DocumentObject 的多态特性，实现更丰富的文档自动化场景。

祝大家写代码写得顺手，文档排版更省心！

以上就是C#使用Spire.Doc设置Word页眉页脚的详细教程的详细内容，更多关于C# Spire.Doc设置Word页眉页脚的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

C#计算程序执行过程花费时间的方法
这篇文章主要介绍了C#计算程序执行过程花费时间的方法,涉及C#简单的时间运算技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-09-09
使用C#实现设置 Excel单元格格式的示例详解
这篇文章主要为大家详细介绍了如何通过使用C#在同一个工作表中设置字体、背景颜色、行高列宽、边框和单元格合并,文中的示例代码讲解详细,需要的小伙伴可以了解下
2025-09-09
Unity UGUI的ToggleGroup选项组件介绍使用
这篇文章主要为大家介绍了Unity UGUI的ToggleGroup选项组件介绍使用示例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-07-07
深入浅析C#泛型类型
这篇文章主要介绍C#泛型类型,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2017-02-02
C#泛型类型知识讲解
这篇文章主要介绍了C#泛型类型知识，文中代码非常详细，帮助大家更好的理解和学习，感兴趣的朋友可以了解下
2020-06-06
浅谈C# 类的继承
本文主要介绍了C# 类的继承相关知识。具有很好的参考价值，下面跟着小编一起来看下吧
2017-01-01
C#如何使用PaddleOCR进行图片文字识别功能
PaddlePaddle（飞桨）是百度开发的深度学习平台，旨在为开发者提供全面、灵活的工具集，用于构建、训练和部署各种深度学习模型，它具有开放源代码、高度灵活性、可扩展性和分布式训练等特点，这篇文章主要介绍了C#使用PaddleOCR进行图片文字识别,需要的朋友可以参考下
2024-04-04
windows中使用C# 调用 C语言生成的dll
本文给大家介绍的是在Windows系统中使用C#调用C语言生成的DLL文件的一种思路，非常的简单实用，有需要的小伙伴可以参考下
2016-11-11
MessageBox的Buttons和三级联动效果
这篇文章主要介绍了MessageBox的Buttons和三级联动的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2016-11-11
C#导入和导出CSV文件
这篇文章介绍了C#导入和导出CSV文件的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-05-05