兼容模式下.doc文档VSTO插件HeaderFooter枚举失效问题

我在Visual Studio 2022中开发了一款C# MS Word VSTO加载项，功能是遍历文档页脚，在不同节的页脚中插入文本框和域代码。该代码处理.docx文档时正常，但处理兼容模式下的.doc文档时，WdHeaderFooterIndex.wdHeaderFooterFirstPage会被错误识别为Word.WdHeaderFooterIndex.wdHeaderFooterPrimary，导致请求插入首页页脚时，内容实际插入到主页脚，最终首页页脚无内容、主页脚出现重复内容。

相关代码 #

foreach (Word.Section section in activeDoc.Sections)
{
    foreach (Word.HeaderFooter footer in section.Footers)
    {
        activeDoc.PageSetup.DifferentFirstPageHeaderFooter = -1;

        // Calculate the width of the page
        float pageWidth = activeDoc.PageSetup.PageWidth;

        // Calculate the top position for the text box
        float textBoxHeight = 24;
        float topPosition = activeDoc.PageSetup.PageHeight - textBoxHeight;

        // Insert the shape
        Word.Shape docIdTextBox = footer.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            0, topPosition, pageWidth, textBoxHeight);
                
        //additional code for formatting the text box/inserting the field code
    }
}

已尝试的解决方法（均无效） #

• 调试确认代码读取HeaderFooter索引正确，但内容仍错误插入到Word.WdHeaderFooterIndex.wdHeaderFooterPrimary
• 通过if (activeDoc.CompatibilityMode == (int)Word.WdCompatibilityMode.wdWord2003)识别兼容模式文档，使用不同代码插入内容
• 不使用循环，直接引用activeDoc.Sections[1].Footers[Word.WdHeaderFooterIndex.wdHeaderFooterFirstPage].Range;
• 更新Visual Studio Tools for Office Runtime至最新版本
• 在VSTO Framework 4.6.2解决方案中引用.NET Framework 4.0类库执行页脚插入代码，尝试规避新版本框架bug

其他说明 #

• 手动将兼容模式.doc转换为.docx后代码运行正常，但公司不允许程序化转换文档
• 测试文档无手动添加的节，仅包含一页（仅首页页脚）或多页（首页页脚+主页脚）

解决方案 #

针对Word兼容模式（.doc）的页脚索引识别问题，可尝试以下两种方案：

方案1：显式指定页脚类型，避免遍历所有页脚 #

放弃遍历section.Footers，改为根据页脚类型直接获取目标对象，同时确保为当前节启用“首页不同”设置后再操作：

foreach (Word.Section section in activeDoc.Sections)
{
    // 为当前节单独启用首页不同的页脚设置
    section.PageSetup.DifferentFirstPageHeaderFooter = -1;

    float pageWidth = section.PageSetup.PageWidth;
    float textBoxHeight = 24;
    float topPosition = section.PageSetup.PageHeight - textBoxHeight;

    // 处理首页页脚
    Word.HeaderFooter firstPageFooter = section.Footers[Word.WdHeaderFooterIndex.wdHeaderFooterFirstPage];
    if (firstPageFooter != null && firstPageFooter.Exists)
    {
        Word.Shape firstPageTextBox = firstPageFooter.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            0, topPosition, pageWidth, textBoxHeight);
        // 首页页脚的格式化和域代码插入逻辑
    }

    // 处理主页脚
    Word.HeaderFooter primaryFooter = section.Footers[Word.WdHeaderFooterIndex.wdHeaderFooterPrimary];
    if (primaryFooter != null && primaryFooter.Exists)
    {
        Word.Shape primaryTextBox = primaryFooter.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            0, topPosition, pageWidth, textBoxHeight);
        // 主页脚的格式化和域代码插入逻辑
    }
}

方案2：通过页脚Index属性显式判断类型 #

遍历页脚时，直接检查每个HeaderFooter的Index值，区分首页和主页脚，避免兼容模式下的索引映射错误：

foreach (Word.Section section in activeDoc.Sections)
{
    section.PageSetup.DifferentFirstPageHeaderFooter = -1;

    float pageWidth = section.PageSetup.PageWidth;
    float textBoxHeight = 24;
    float topPosition = section.PageSetup.PageHeight - textBoxHeight;

    foreach (Word.HeaderFooter footer in section.Footers)
    {
        // 显式判断当前页脚类型
        if (footer.Index == (int)Word.WdHeaderFooterIndex.wdHeaderFooterFirstPage)
        {
            Word.Shape docIdTextBox = footer.Shapes.AddTextbox(
                Office.MsoTextOrientation.msoTextOrientationHorizontal,
                0, topPosition, pageWidth, textBoxHeight);
            // 首页页脚的处理逻辑
        }
        else if (footer.Index == (int)Word.WdHeaderFooterIndex.wdHeaderFooterPrimary)
        {
            Word.Shape docIdTextBox = footer.Shapes.AddTextbox(
                Office.MsoTextOrientation.msoTextOrientationHorizontal,
                0, topPosition, pageWidth, textBoxHeight);
            // 主页脚的处理逻辑
        }
    }
}

关键注意事项 #

• 必须针对当前节设置DifferentFirstPageHeaderFooter，而非全局的activeDoc.PageSetup，Word的节设置是独立的
• 操作页脚前先检查footer.Exists属性，避免操作未初始化的页脚对象（兼容模式下可能默认不存在首页页脚）

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