如何读取Word文档模板的XML映射值？SharePoint Online技术求助

用C#读取Word文档的XML映射列值 #

可以借助Open XML SDK直接操作Word的OOXML结构来读取映射列值，Word的内容控件映射信息存储在customXml和文档属性相关节点中，具体实现步骤如下：

1. 安装依赖包 #

先通过NuGet安装DocumentFormat.OpenXml包：

Install-Package DocumentFormat.OpenXml

2. 核心代码示例 #

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using System.Xml;
using System.Collections.Generic;

public static Dictionary<string, string> ExtractXmlMappedValues(string wordFilePath)
{
    var mappedValues = new Dictionary<string, string>();

    using (var doc = WordprocessingDocument.Open(wordFilePath, false))
    {
        var mainPart = doc.MainDocumentPart;
        if (mainPart == null) return mappedValues;

        // 遍历所有内容控件
        foreach (var sdtElement in mainPart.Document.Descendants<SdtElement>())
        {
            var props = sdtElement.SdtProperties;
            if (props == null) continue;

            // 获取绑定的XML映射信息
            var dataBinding = props.Descendants<DataBinding>().FirstOrDefault();
            if (dataBinding == null || string.IsNullOrWhiteSpace(dataBinding.Xpath) || string.IsNullOrWhiteSpace(dataBinding.StoreItemId))
                continue;

            // 找到对应的自定义XML部件
            var customXmlPart = doc.CustomXmlParts.FirstOrDefault(p => p.Uri.ToString().EndsWith(dataBinding.StoreItemId));
            if (customXmlPart == null) continue;

            // 加载XML并通过XPath取值
            var xmlDoc = new XmlDocument();
            xmlDoc.Load(customXmlPart.GetStream());
            var nsManager = new XmlNamespaceManager(xmlDoc.NameTable);
            // 必须添加XML映射的命名空间，否则XPath查询会失效
            nsManager.AddNamespace("ns", xmlDoc.DocumentElement.NamespaceURI);

            var targetNode = xmlDoc.SelectSingleNode(dataBinding.Xpath, nsManager);
            if (targetNode != null)
            {
                mappedValues.Add(dataBinding.Xpath, targetNode.InnerText);
            }
        }
    }

    return mappedValues;
}

3. 常见问题排查 #

• 命名空间缺失：这是大部分XPath查询失败的原因，一定要将映射XML的命名空间添加到XmlNamespaceManager中。
• StoreItemId匹配错误：每个XML映射对应唯一的CustomXmlPart，需确保DataBinding.StoreItemId与部件的URI后缀完全匹配。
• 复杂控件处理：如果是重复节、表格类的绑定控件，需要针对性遍历SdtBlock、SdtRun等不同类型的内容控件节点。

其他替代方案 #

• PowerShell批量处理：借助.NET的Open XML SDK库，用PowerShell实现类似逻辑，适合批量扫描文档：

Add-Type -Path "DocumentFormat.OpenXml.dll"
# 后续逻辑可参考C#代码的思路转换

• Word VBA直接读取：在Word内编写VBA脚本快速获取绑定值：

Sub ListMappedContentControls()
    Dim cc As ContentControl
    For Each cc In ActiveDocument.ContentControls
        If cc.XMLMapping.IsMapped Then
            Debug.Print "XPath: " & cc.XMLMapping.XPath & " | 值: " & cc.Range.Text
        End If
    Next cc
End Sub

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