通过CustomXmlParts更新空内容类型属性时的Word报错问题

我正在用C#开发VSTO Word插件，SharePoint的内容类型属性（ContentTypeProperties）存储在命名空间为http://schemas.microsoft.com/office/2006/metadata/properties的CustomXmlPart中，目前已实现属性的读取与更新功能。

当前使用的更新方法如下：

public static bool UpdateContentTypeProperty(string propertyName, string propertyValue)
{
    // Update the node's text if the property value is not null or whitespace
    if (string.IsNullOrWhiteSpace(propertyValue))
    {
        Logger.Warn($"Property {propertyName} value is null or whitespace.");
        return false;
    }

    try
    {
        var doc = Globals.ThisAddIn.Application.ActiveDocument;
        var customXMLParts = doc.CustomXMLParts.SelectByNamespace("http://schemas.microsoft.com/office/2006/metadata/properties");

        if (customXMLParts.Count <= 0)
            return false;

        foreach (CustomXMLPart part in customXMLParts)
        {
            var node = part.SelectSingleNode($"//*[local-name()='{propertyName}']");

            if (node != null)
            {
                // Only works if the property already has a value, else it will throw an exception
                node.Text = propertyValue;
                Logger.Info($"Property {propertyName} updated to value {propertyValue}.");
                return true;
            }
        }
        throw new Exception($"Property {propertyName} not found in custom XML parts.");
    }
    catch (Exception)
    {
        throw;
    }
}

当属性已有值时，更新功能正常：

Before:
<Doc-Template-Name xmlns="501d336e-520f-475f-a88e-1742c35e8566">{template-name}</Doc-Template-Name>

After: 
<Doc-Template-Name xmlns="501d336e-520f-475f-a88e-1742c35e8566">Example Template</Doc-Template-Name>

核心问题：更新带xsi:nil="true"的空属性时，直接设置node.Text后，Word无法读取该CustomXmlPart中的任何属性，提示错误："无法显示此文件中的服务器属性"。更新前后的XML示例：

Before:
<Doc-Version xmlns="501d336e-520f-475f-a88e-1742c35e8566" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"></Doc-Version>

After: 
<Doc-Version xmlns="501d336e-520f-475f-a88e-1742c35e8566" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true">TestValue</Doc-Version>

已尝试的方案：

• 用占位符预填充属性，效果不理想；
• 尝试通过node.Attributes操作xsi:nil属性，但属性计数为0，无法操作；
• 删除xsi:nil属性后重新添加CustomXmlPart，问题仍存在，仅保存文件后恢复，但需要无需保存的强制刷新方法。

1. 修复xsi:nil属性处理逻辑 #

核心问题是：带有xsi:nil="true"的节点在XML Schema中定义为"空值"，不能包含文本内容，直接设置node.Text会破坏XML结构，导致Word解析失败。需要先移除该属性再设置文本，注意要通过命名空间精准定位属性（之前无法操作属性是因为没指定xsi命名空间）：

修改更新方法中的节点处理逻辑：

if (node != null)
{
    // 定位xsi:nil属性，必须指定xsi的命名空间URI
    const string xsiNamespace = "http://www.w3.org/2001/XMLSchema-instance";
    var nilAttr = node.Attributes.SelectSingleNode($"@*[local-name()='nil' and namespace-uri()='{xsiNamespace}']");
    
    // 如果存在xsi:nil属性则删除
    if (nilAttr != null)
    {
        nilAttr.Delete();
    }
    
    // 现在可以安全设置属性值
    node.Text = propertyValue;
    Logger.Info($"Property {propertyName} updated to value {propertyValue}.");
    return true;
}

2. 无需保存的强制刷新方法 #

修改CustomXmlPart后，Word可能不会即时刷新服务器属性面板，可通过以下两种方式触发即时刷新：

方式1：触发文档微小变更（通用方法）

通过插入并删除一个不可见字符，让Word重新加载CustomXmlPart：

var doc = Globals.ThisAddIn.Application.ActiveDocument;
// 定位到文档末尾
var range = doc.Content;
range.Collapse(WdCollapseDirection.wdCollapseEnd);
// 插入零宽度空格（不可见）
range.Text = "\u200B";
// 立即删除该字符
range.Delete();

方式2：刷新文档信息（针对SharePoint场景）

调用Word内置的文档信息更新方法，直接刷新服务器属性面板：

Globals.ThisAddIn.Application.ActiveDocument.UpdateDocumentInformation();

3. 优化异常处理 #

原方法中捕获异常后直接抛出，建议添加详细日志，方便后续排查问题：

catch (Exception ex)
{
    Logger.Error($"Failed to update property {propertyName}: {ex.Message}", ex);
    throw;
}

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