上次修改时间: 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 |
覆盖现有内容。 |
子元素
元素 |
说明 |
|---|---|
将一个 XPath 表达式 映射到已爬网属性。 |
父元素
元素 |
说明 |
|---|---|
指定一组从 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 值的已爬网属性。