Open XML SDK：页眉中内容控件文本无法更新的问题排查

可能的错误原因 #

• 控件匹配逻辑错误：你通过SdtAlias.Val匹配内容控件名称，但OpenXML中，内容控件的**开发者标签（Name）**对应的是SdtTag元素的Val属性，SdtAlias仅为控件的显示别名，二者常不一致。
• 文本节点处理不彻底：内容控件内的文本可能被拆分为多个Text元素，仅修改第一个无法完全替换原有内容；若原文本节点为空，修改操作会直接失效。
• 节点层级遍历遗漏：部分内容控件的文本嵌套在SdtContent→Paragraph→Run层级下，直接遍历SdtElement的Descendants<Text>可能无法定位到有效节点。

修正后的代码实现 #

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

var headerParts = document.MainDocumentPart.HeaderParts;
foreach (var headerPart in headerParts)
{
    // 通过SdtTag匹配内容控件的开发者标签（即控件名称）
    var targetSdt = headerPart.RootElement
        .Descendants<SdtElement>()
        .FirstOrDefault(sdt => sdt.SdtProperties.GetFirstChild<SdtTag>()?.Val == "Header");

    if (targetSdt != null)
    {
        // 获取内容控件的内容容器
        var sdtContent = targetSdt.Descendants<SdtContent>().FirstOrDefault();
        if (sdtContent != null)
        {
            // 清空原有所有内容
            sdtContent.RemoveAllChildren();
            
            // 构建新的文本结构：段落→运行→文本
            var newParagraph = new Paragraph();
            var newRun = new Run(new Text("Text changed"));
            newParagraph.Append(newRun);
            sdtContent.Append(newParagraph);
            
            // 保存当前页眉的修改
            headerPart.Header.Save();
        }
    }
}
// 保存整个文档
document.Save();

验证与注意事项 #

• 确认内容控件的开发者标签为Header：打开Word文档，进入「开发者工具」→「内容控件属性」，查看「标签」字段是否与代码中一致。
• 若文档设置了多页眉（如首页/奇偶页不同），需确保目标控件所在的页眉被遍历到。
• 可使用OpenXML SDK Productivity Tool检查文档结构，确认修改是否正确写入。

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