如何使用OpenXML识别Word文档各节/页面的页眉页脚类型

Word的页眉页脚设置是绑定到**节（Section）**的，每个节可独立配置规则，需先定位页面所属节，再读取节属性判断类型。

1. 判断第一页是否为特殊首页页眉 #

• 定位文档第一个节的SectionProperties节点
• 检查是否包含TitlePage元素：只要存在该元素（或其Val属性为true，默认值即为true），说明节启用了首页不同页眉页脚
• 额外验证：节下是否有HeaderReference元素且Type为First，确认存在对应首页页眉内容

示例代码（C#）：

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;

public bool HasFirstPageUniqueHeader(WordprocessingDocument doc)
{
    var mainPart = doc.MainDocumentPart;
    var firstSectionProps = mainPart.Document.Body.Elements<SectionProperties>().FirstOrDefault();
    if (firstSectionProps == null) return false;

    // 检查首页特殊设置开关
    var titlePageSetting = firstSectionProps.Elements<TitlePage>().FirstOrDefault();
    if (titlePageSetting != null && (titlePageSetting.Val == null || titlePageSetting.Val.Value))
    {
        // 确认存在首页页眉引用
        return firstSectionProps.Elements<HeaderReference>()
            .Any(h => h.Type == HeaderFooterValues.First);
    }
    return false;
}

2. 判断第二页的奇偶页页眉设置 #

• 先确认第二页所属节：若第一页是单独节（带SectionBreak），则第二页属于第二个节；否则仍在第一个节
• 找到对应节的SectionProperties节点，检查是否包含OddAndEvenHeaders元素：存在且Val为true时，说明启用奇偶页不同页眉
• 验证：节下需同时存在Type为Odd和Even的HeaderReference元素

示例代码：

public bool HasOddEvenHeaderSetting(WordprocessingDocument doc, int targetSectionIndex = 0)
{
    var mainPart = doc.MainDocumentPart;
    var sectionPropsList = mainPart.Document.Body.Elements<SectionProperties>().ToList();
    if (targetSectionIndex >= sectionPropsList.Count) return false;

    var sectionProps = sectionPropsList[targetSectionIndex];
    var oddEvenSetting = sectionProps.Elements<OddAndEvenHeaders>().FirstOrDefault();
    if (oddEvenSetting != null && (oddEvenSetting.Val == null || oddEvenSetting.Val.Value))
    {
        // 确认奇偶页眉引用都存在
        var hasOdd = sectionProps.Elements<HeaderReference>().Any(h => h.Type == HeaderFooterValues.Odd);
        var hasEven = sectionProps.Elements<HeaderReference>().Any(h => h.Type == HeaderFooterValues.Even);
        return hasOdd && hasEven;
    }
    return false;
}

3. 判断第三页的常规页眉页脚类型 #

• 常规页眉指未启用首页、奇偶页特殊设置，仅使用默认页眉的情况
• 检查对应节的SectionProperties：
  • 无TitlePage元素，或TitlePage.Val为false
  • 无OddAndEvenHeaders元素，或OddAndEvenHeaders.Val为false
  • 存在Type为Default的HeaderReference元素

示例代码：

public bool HasNormalHeader(WordprocessingDocument doc, int targetSectionIndex = 0)
{
    var mainPart = doc.MainDocumentPart;
    var sectionPropsList = mainPart.Document.Body.Elements<SectionProperties>().ToList();
    if (targetSectionIndex >= sectionPropsList.Count) return false;

    var sectionProps = sectionPropsList[targetSectionIndex];
    // 检查是否未开启首页、奇偶页特殊设置
    var hasFirstPageSetting = sectionProps.Elements<TitlePage>().Any(t => t.Val == null || t.Val.Value);
    var hasOddEvenSetting = sectionProps.Elements<OddAndEvenHeaders>().Any(o => o.Val == null || o.Val.Value);

    if (!hasFirstPageSetting && !hasOddEvenSetting)
    {
        // 确认存在默认页眉引用
        return sectionProps.Elements<HeaderReference>()
            .Any(h => h.Type == HeaderFooterValues.Default);
    }
    return false;
}

关键注意事项 #

• 页面与节的对应关系：一个节可包含多页，需通过段落中的SectionBreak元素判断页面所属节
• 页眉页脚的实际内容：HeaderReference的Id会关联到HeaderPart，可读取该部件内容确认是否有实际内容
• 属性继承：后续节未设置页眉页脚属性时，会自动继承前一节的设置

内容的提问来源于stack exchange，提问作者KeDaR