快捷導(dǎo)航

C#使用Spire.Doc設(shè)置Word頁(yè)眉頁(yè)腳的詳細(xì)教程

更新時(shí)間：2026年03月03日 10:01:54 作者：缺點(diǎn)內(nèi)向

在日常的辦公自動(dòng)化中,Word 文檔的頁(yè)眉頁(yè)腳經(jīng)常被用來(lái)放置公司 LOGO、標(biāo)題、頁(yè)碼等信息,本文給大家介紹了如何借助 C# 與強(qiáng)大的文檔處理庫(kù) Spire.Doc,讓我們可以在代碼層面靈活地對(duì)頁(yè)眉頁(yè)腳進(jìn)行增刪改查,需要的朋友可以參考下

1. 為什么選擇 Spire.Doc？
2. 基礎(chǔ)：向文檔添加頁(yè)眉頁(yè)腳
3. 只在首頁(yè)顯示特殊頁(yè)眉
4. 跨文檔復(fù)制頁(yè)眉頁(yè)腳
5. 調(diào)整頁(yè)眉頁(yè)腳與正文的距離
6. 使用 DocumentNavigator 定位到頁(yè)眉頁(yè)腳（進(jìn)階）
7. 實(shí)戰(zhàn)建議
8. 小結(jié)

在日常的辦公自動(dòng)化中，Word 文檔的頁(yè)眉頁(yè)腳經(jīng)常被用來(lái)放置公司 LOGO、標(biāo)題、頁(yè)碼等信息。傳統(tǒng)的手工操作既繁瑣，又容易出錯(cuò)，尤其是需要批量生成大量文檔時(shí)更是如此。借助 C# 與強(qiáng)大的文檔處理庫(kù) Spire.Doc，我們可以在代碼層面靈活地對(duì)頁(yè)眉頁(yè)腳進(jìn)行增刪改查，從而實(shí)現(xiàn)自動(dòng)化、統(tǒng)一化的文檔排版。

1. 為什么選擇 Spire.Doc？

Spire.Doc 是一款純 .NET 實(shí)現(xiàn)的 Word 操作組件，支持 .doc/.docx 格式的讀取、編輯、保存。相比于 Microsoft.Office.Interop，它不依賴 Office 安裝，運(yùn)行時(shí)占用資源更少，且提供了豐富的 API 來(lái)直接操作 HeaderFooter、Section、Paragraph、DocPicture 等對(duì)象，非常適合服務(wù)器端或后臺(tái)服務(wù)使用。

2. 基礎(chǔ)：向文檔添加頁(yè)眉頁(yè)腳

下面的示例演示了如何在一個(gè) Section 中創(chuàng)建頁(yè)眉頁(yè)腳，并向其中插入圖片、文字以及頁(yè)碼。

private void InsertHeaderAndFooter(Section section)
{
    // 獲取頁(yè)眉、頁(yè)腳對(duì)象
    HeaderFooter header = section.HeadersFooters.Header;
    HeaderFooter footer = section.HeadersFooters.Footer;

    // ---------- 頁(yè)眉 ----------
    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;

    // ---------- 頁(yè)腳 ----------
    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;

    // 添加頁(yè)碼字段
    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;
}

圖片定位：通過(guò) HorizontalOrigin/VerticalOrigin 與 ShapeHorizontalAlignment/ShapeVerticalAlignment 可以實(shí)現(xiàn)圖片相對(duì)頁(yè)面的絕對(duì)定位，常用于 LOGO 或公司標(biāo)識(shí)的固定展示。
頁(yè)碼：FieldType.FieldPage 與 FieldType.FieldNumPages 組合即可得到“第 X 頁(yè) / 共 Y 頁(yè)”的效果，且會(huì)隨文檔頁(yè)數(shù)自動(dòng)更新。

3. 只在首頁(yè)顯示特殊頁(yè)眉

有時(shí)公司報(bào)告要求首頁(yè)使用獨(dú)立的標(biāo)題頁(yè)眉，而后續(xù)頁(yè)面使用統(tǒng)一的頁(yè)眉。Spire.Doc 通過(guò) PageSetup.DifferentFirstPageHeaderFooter 來(lái)實(shí)現(xiàn)。

// 讓所有節(jié)的首頁(yè)使用獨(dú)立的頁(yè)眉/頁(yè)腳
foreach (Section sec in doc2.Sections)
{
    sec.PageSetup.DifferentFirstPageHeaderFooter = true;
}

// 將源文檔的普通頁(yè)眉復(fù)制到目標(biāo)文檔的首頁(yè)頁(yè)眉
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());
}

關(guān)鍵點(diǎn)在于：

開(kāi)啟差異頁(yè)眉：DifferentFirstPageHeaderFooter = true 后，FirstPageHeader 與普通 Header 會(huì)被視為兩個(gè)獨(dú)立對(duì)象。
對(duì)象克隆：直接復(fù)制 ChildObjects 并使用 Clone()，可以保證圖形、文本、字段等屬性完整遷移。

4. 跨文檔復(fù)制頁(yè)眉頁(yè)腳

在批量生成報(bào)告時(shí)，往往需要把統(tǒng)一的頁(yè)眉頁(yè)腳模板復(fù)制到每一個(gè)新文檔。下面的代碼展示了如何一次性將源文檔的頁(yè)眉復(fù)制到目標(biāo)文檔的所有節(jié)。

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());
    }
}

小技巧：如果目標(biāo)文檔已經(jīng)包含內(nèi)容，建議先 Clear() 目標(biāo)節(jié)的頁(yè)眉，以免出現(xiàn)重復(fù)元素。

5. 調(diào)整頁(yè)眉頁(yè)腳與正文的距離

不同的排版需求可能要求頁(yè)眉離頁(yè)面頂部更近或更遠(yuǎn)。Spire.Doc 提供了 HeaderDistance 與 FooterDistance 兩個(gè)屬性來(lái)控制這個(gè)間距（單位為磅，1 英寸≈72 磅）。

Section sec = doc.Sections[0];
sec.PageSetup.HeaderDistance = 100; // 約 1.39 英寸
sec.PageSetup.FooterDistance = 100;

合理的距離可以避免頁(yè)眉與正文重疊，提升文檔的可讀性。

6. 使用 DocumentNavigator 定位到頁(yè)眉頁(yè)腳（進(jìn)階）

DocumentNavigator 是 Spire.Doc 中的光標(biāo)對(duì)象，適合在遍歷文檔樹(shù)時(shí)臨時(shí)跳轉(zhuǎn)到頁(yè)眉或頁(yè)腳。

DocumentNavigator nav = doc.Navigator;
nav.MoveToHeaderFooter(HeaderFooterType.Header); // 移動(dòng)到當(dāng)前節(jié)的頁(yè)眉
// 此時(shí)可以對(duì) nav.CurrentParagraph 進(jìn)行編輯

該方法在需要 在文檔遍歷過(guò)程中 動(dòng)態(tài)修改頁(yè)眉/頁(yè)腳時(shí)尤為便利。

7. 實(shí)戰(zhàn)建議

場(chǎng)景	推薦實(shí)現(xiàn)方式
統(tǒng)一模板	在代碼啟動(dòng)時(shí)加載一次模板文檔，僅復(fù)制 `HeaderFooter`，避免重復(fù)讀取磁盤(pán)。
不同章節(jié)不同頁(yè)眉	為每個(gè)章節(jié)創(chuàng)建獨(dú)立的 `Section`，并分別設(shè)置 `HeadersFooters`。
自動(dòng)分頁(yè)	使用 `Section.PageSetup.DifferentFirstPageHeaderFooter` 配合 `FieldPage`，無(wú)需手動(dòng)計(jì)算頁(yè)碼。
性能優(yōu)化	大批量生成時(shí)，使用 `doc.SaveToStream()` 并一次性寫(xiě)入磁盤(pán)，可顯著提升 I/O 效率。

8. 小結(jié)

通過(guò) Spire.Doc，C# 開(kāi)發(fā)者可以在幾行代碼內(nèi)完成 Word 文檔頁(yè)眉頁(yè)腳的創(chuàng)建、復(fù)制、定制和排版。無(wú)論是公司報(bào)告、合同模板，還是批量生成的發(fā)票，都能實(shí)現(xiàn)統(tǒng)一風(fēng)格、自動(dòng)分頁(yè)、靈活布局的目標(biāo)。掌握上述核心 API 后，你就可以把繁瑣的手工排版工作交給代碼完成，讓文檔生成變得更加高效、可靠。

延伸閱讀：如果你需要更高級(jí)的功能（如在頁(yè)眉中嵌入動(dòng)態(tài)表格、條件顯示），可以進(jìn)一步探索 HeaderFooter 的 ChildObjects 結(jié)構(gòu)，結(jié)合 DocumentObject 的多態(tài)特性，實(shí)現(xiàn)更豐富的文檔自動(dòng)化場(chǎng)景。

祝大家寫(xiě)代碼寫(xiě)得順手，文檔排版更省心！

以上就是C#使用Spire.Doc設(shè)置Word頁(yè)眉頁(yè)腳的詳細(xì)教程的詳細(xì)內(nèi)容，更多關(guān)于C# Spire.Doc設(shè)置Word頁(yè)眉頁(yè)腳的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: