使用C# OPEN XML SDK生成Word目录后消除打开提示的方案咨询

我之前也遇到过一模一样的情况——用C# Open XML SDK生成带目录的docx后，每次打开都弹那个烦人的更新提示，总不能让每个用户都去改Word设置吧？这里有两个不用动用户配置的靠谱方案，你可以根据需求选：

方案1：把目录转换成静态文本（彻底消除域） #

如果你的目录生成后不需要再更新，直接把动态的TOC域换成纯文本就行，这样打开文档时完全不会触发任何域检测逻辑。

具体做法是：先按正常流程生成TOC，然后遍历文档找到TOC域的节点，把整个域替换成它显示的内容。代码示例如下：

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

public static void ConvertTocToStaticText(WordprocessingDocument doc)
{
    var mainPart = doc.MainDocumentPart;
    // 定位所有TOC域的开始标记
    var tocStartFields = mainPart.Document.Descendants<FieldChar>()
        .Where(fc => fc.FieldCharType == FieldCharValues.Begin && 
                     fc.NextSibling<Run>()?.Descendants<Text>().Any(t => t.Text.StartsWith("TOC ")) == true);

    foreach (var tocStart in tocStartFields.ToList())
    {
        // 找到对应TOC域的结束标记
        var currentNode = tocStart.NextSibling();
        FieldChar tocEnd = null;
        while (currentNode != null)
        {
            if (currentNode is FieldChar fc && fc.FieldCharType == FieldCharValues.End)
            {
                tocEnd = fc;
                break;
            }
            currentNode = currentNode.NextSibling();
        }

        if (tocEnd == null) continue;

        // 收集域中间显示的实际目录内容（跳过域的控制节点）
        var staticContent = new List<OpenXmlElement>();
        currentNode = tocStart.NextSibling();
        while (currentNode != tocEnd)
        {
            var temp = currentNode.NextSibling();
            if (!(currentNode is FieldChar))
            {
                staticContent.Add(currentNode.CloneNode(true));
            }
            currentNode = temp;
        }

        // 用静态内容替换整个TOC域
        tocStart.Parent.InsertAfterSelf(staticContent);
        // 删除原有的域节点
        currentNode = tocStart;
        while (currentNode != tocEnd.NextSibling())
        {
            var temp = currentNode.NextSibling();
            currentNode.Remove();
            currentNode = temp;
        }
    }

    mainPart.Document.Save();
}

记得在你生成完TOC、完成所有文档内容后调用这个方法，目录就会变成纯文本，再也不会弹提示了。

方案2：锁定TOC域（保留域结构但禁止提示更新） #

如果还想保留TOC域的可更新性（比如用户以后可以右键手动刷新目录），但不想每次打开都弹提示，可以给TOC域添加锁定属性，有两种实现方式：

方式A：在TOC域代码中加入\lock开关 #

生成TOC的FieldCode时，在参数末尾加上\lock。比如原来的域代码是"TOC \\o \"1-3\" \\h \\z \\u"，改成"TOC \\o \"1-3\" \\h \\z \\u \\lock"。Word识别到这个开关后，会锁定该域，打开时不会提示更新。

代码片段示例：

// 构造带锁定开关的TOC域代码
var tocFieldCode = new Text("TOC \\o \"1-3\" \\h \\z \\u \\lock") { Space = SpaceProcessingModeValues.Preserve };
var fieldCodeRun = new Run(tocFieldCode);

// 构造TOC域的首尾标记
var beginFieldChar = new FieldChar { FieldCharType = FieldCharValues.Begin };
var separatorFieldChar = new FieldChar { FieldCharType = FieldCharValues.Separator };
var endFieldChar = new FieldChar { FieldCharType = FieldCharValues.End };

// 将这些节点添加到目标段落中（具体位置根据你的代码调整）
var tocParagraph = new Paragraph();
tocParagraph.Append(beginFieldChar);
tocParagraph.Append(fieldCodeRun);
tocParagraph.Append(separatorFieldChar);
// 这里可以添加域结果占位，或者让Word后续自动生成（如果需要）
tocParagraph.Append(endFieldChar);

方式B：设置FieldChar的Lock属性 #

直接给TOC域的开始标记FieldChar添加Lock="true"属性，效果和加\lock开关一致：

var beginFieldChar = new FieldChar 
{ 
    FieldCharType = FieldCharValues.Begin,
    Lock = OnOffValue.FromBoolean(true)
};

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