MappingGroup 元素

上次修改时间: 2015年3月9日

适用范围: SharePoint Server 2010

<MappingGroup base-path='basePath' attr='propName' propset='GUID' type='varType' sep-str='separator' pre-str='preString' post-str='postString' rec-sep-str='recSeparator' rec-pre-str='recPreString' rec-post-str='recPostString' select='merge|first|longest' mode='append|prepend|overwrite'></MappingGroup>

属性和元素

以下各部分介绍了属性、子元素和父元素。

属性

属性

说明

base-path

必需。指定一个 XPath 基路径,该路径是此组中的 Mapping 元素的相对路径。

attr

必需。指定所创建的已爬网属性的属性名称。

propset

可选。指定一个表示十六进制属性集 GUID 的字符串。替代默认属性集。仅在该元素不是 MappingGroup 元素的一部分时适用。

type

可选。指定一个替代默认变量类型的变量类型。仅在该元素不是 MappingGroup 元素的一部分时适用。

sep-str

可选。指定在 base-path 匹配多个 XML 节点时的分隔字符串。

默认值:单个空格字符。

pre-str

可选。指定要预置到已提取内容的字符串。

默认值:空字符串。

post-str

可选。指定要追加到已提取内容的字符串。

默认值:空字符串。

rec-sep-str

可选。指定要在组中每个 Mapping 元素的内容之间使用的字符串分隔符。

默认值:单个空格字符。

rec-pre-str

可选。指定要预置到组中第一个 Mapping 元素的字符串。

rec-post-str

可选。指定要追加到组中最后一个 Mapping 元素的字符串。

select

可选。定义要检索其内容的 Mapping 元素。

默认值:merge

mode

可选。定义在其他 Mapping 元素或 MappingGroup 元素已将内容映射到同一属性名称时的行为。

默认值:append

属性

说明

merge

使用 rec-sep-str、rec-pre-str 和 rec-post-str 属性合并来自所有元素的内容。

first

从具有内容的第一个元素获取内容。

longest

从具有最长内容的元素获取内容。

属性

说明

append

向现有内容的末端添加新内容。

prepend

向现有内容的开头添加新内容。

overwrite

覆盖现有内容。

子元素

元素

说明

Mapping

将一个 XPath 表达式 映射到已爬网属性。

父元素

元素

说明

XMLMappings

指定一组从 XPath 表达式到已爬网属性的映射。

示例

第一个代码节提供示例 XML 输入。第二个代码节提供一个关联的 XML 映射器配置,该配置提供 MappingGroup 内的两个 Mapping 表达式。

<Document>
  <Tags>
    <Keywords>funny</Keywords>
    <UserTags>hilarious</UserTags>
  </Tags>
</Document>
<XMLMappings>
  <MappingGroup attr="mytags" base-path="//Tags" rec-sep-str=",">
    <Mapping path="Keywords"/>
    <Mapping path="UserTags"/>
  </MappingGroup>
</XMLMappings>

此示例将生成一个具有 funny,hilarious 值的已爬网属性。

请参阅

概念

自定义 XML 项处理

XML 映射程序架构