如何在 .NET 中处理自定义 XML 标记

步骤 1：从文档读取自定义 XML 数据

Document.CustomXmlParts 返回一个 CustomXmlPartCollection —— 这与 Word 用于支持 XML 映射内容控件的机制相同。遍历该集合，或在已知所需部件时调用 GetById(id)，以获取一个 CustomXmlPart。每个部件公开 Id，一个 Data 字节数组，保存原始 XML，以及一个用于在不进行完整字节比较的情况下检测数据是否已更改的 DataChecksum，还有 Schemas —— 一个列出与其关联的 XML 架构的 CustomXmlSchemaCollection。

步骤 2：添加或更新自定义 XML 部件

调用 CustomXmlPartCollection.Add(id, xml) 并提供 id 字符串和 XML 内容以直接创建部件，或者单独构造一个 CustomXmlPart 并将其传递给 Add(part)。要删除数据，可在特定位置使用 RemoveAt(index)，或使用 Clear() 删除所有部件。复制自定义 XML 数据到文档之间时，使用源部件上的 CustomXmlPart.Clone()（或集合的 Clone()），而不是重新读取并重新添加原始 XML，然后将克隆添加到目标文档的 Document.CustomXmlParts。

步骤 3：管理与部件关联的模式

CustomXmlPart.Schemas 达到一个 CustomXmlSchemaCollection，该对象将与部件关联的模式 URI 记录为普通字符串，而不是已解析的模式对象。使用 Add(value) 注册模式 URI，使用 Remove(name) 或 RemoveAt(index) 删除某个 URI，使用 IndexOf(value) 定位某个 URI，使用 Clear() 删除全部。Count 报告当前与部件关联的模式 URI 数量。

步骤 4：处理包级自定义部件

并非 OOXML 包中所有不可见的部件都是自定义 XML。Document.PackageCustomParts 返回一个包含 CustomPart 对象的 CustomPartCollection —— 存储在包中的任意部件，例如被其他应用程序触碰后添加的部件。每个 CustomPart 都有一个 Name、ContentType、RelationshipType、一个 Data 字节数组，以及一个 IsExternal 标志，用于指示它是外部引用还是嵌入内容。Add(part)、RemoveAt(index) 和 Clear() 以与 CustomXmlPartCollection 相同的方式管理该集合。当文档应包含的部件未出现在自定义 XML 集合中时，请检查 PackageCustomParts —— 而不是 CustomXmlParts ——。

步骤 5：检查旧版智能标签及其属性

SmartTag 是一种节点类型（NodeType.SmartTag，使用 SmartTag(doc) 构造），表示包装在已识别文本周围的旧版 Word 智能标签。检查 Element 和 Uri 以确定是哪个识别器创建了该标签，然后读取 Properties —— 一个 CustomXmlPropertyCollection —— 来获取识别器附加的结构化数据。在 CustomXmlPropertyCollection 中，索引器（例如 properties["MyProp"]）或 Contains(name) 查找特定属性，IndexOfKey(name) 返回其位置，Remove(name)/RemoveAt(index)/Clear() 删除条目；每个 CustomXmlProperty 使用 CustomXmlProperty(name, uri, value) 构造，并公开 Name、Uri 和 Value。由于 SmartTag 派生自 CompositeNode，它也像其他节点一样参与文档树，支持用于基于 DocumentVisitor 的遍历的 Accept(visitor)、AcceptStart(visitor) 和 AcceptEnd(visitor)。