XmlMapping

XmlMapping class

指定用于在 parent 结构化文档标记和存储在文档中的自定义 XML 数据部分中的 XML 元素之间建立映射的信息。

要了解更多信息，请访问结构化文档标签或内容控制文档文章。

public class XmlMapping

特性

姓名描述
CustomXmlPart { get; }返回父结构化文档标签映射到的自定义 XML 数据部分。
IsMapped { get; }返回真的如果父结构化文档标签成功映射到 XML 数据。
PrefixMappings { get; }返回 XML 命名空间前缀映射以评估XPath.
StoreItemId { get; }指定自定义 XML 数据部分的自定义 XML 数据标识符，该标识符应用于评估XPath表达式.
XPath { get; }返回 XPath 表达式，该表达式用于查找映射到父结构化文档标签的自定义 XML 节点 。

方法

姓名描述
Delete()删除父结构化文档到 XML 数据的映射。
SetMapping(CustomXmlPart, string, string)设置父结构化文档标签和自定义 XML 数据部分的 XML 节点之间的映射。

例子

展示如何为自定义 XML 部分设置 XML 映射。

Document doc = new Document();

// 构造一个包含文本的 XML 部分并将其添加到文档的 CustomXmlPart 集合中。
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

Assert.AreEqual("<root><text>Text element #1</text><text>Text element #2</text></root>",
    Encoding.UTF8.GetString(xmlPart.Data));

// 创建一个结构化文档标签，它将显示我们的 CustomXmlPart 的内容。
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);

// 为我们的结构化文档标签设置一个映射。此映射将指示
// 我们的结构化文档标签显示 XPath 指向的 XML 部分文本内容的一部分。
// 在这种情况下，它将是第一个“<root>”元素的第二个“<text>”元素的内容：“Text element #2”。
tag.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", "xmlns:ns='http://www.w3.org/2001/XMLSchema'");

Assert.True(tag.XmlMapping.IsMapped);
Assert.AreEqual(xmlPart, tag.XmlMapping.CustomXmlPart);
Assert.AreEqual("/root[1]/text[2]", tag.XmlMapping.XPath);
Assert.AreEqual("xmlns:ns='http://www.w3.org/2001/XMLSchema'", tag.XmlMapping.PrefixMappings);

// 将结构化文档标签添加到文档中以显示来自我们自定义部分的内容。
doc.FirstSection.Body.AppendChild(tag);
doc.Save(ArtifactsDir + "StructuredDocumentTag.XmlMapping.docx");

也可以看看

StructuredDocumentTagRangeStart Class