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 部分文本内容的一部分。
// 在这种情况下，它将是第二个“<text>”的内容第一个“<root>”的元素元素：“文本元素#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