Partager via


MappingGroup, élément

Dernière modification : mardi 22 juin 2010

S’applique à : 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>

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut

Description

base-path

Obligatoire. Spécifie un chemin d’accès de base XPath relatif pour les éléments Mapping contenus dans ce groupe.

attr

Obligatoire. Spécifie le nom de propriété de la propriété analysée créée.

propset

Facultatif. Spécifie une chaîne qui représente un GUID de jeu de propriétés hexadécimal. Remplace le jeu de propriétés par défaut. S’applique uniquement lorsque l’élément ne fait pas partie d’un élément MappingGroup.

type

Facultatif. Spécifie un type variant qui remplace le type variant par défaut. S’applique uniquement lorsque l’élément ne fait pas partie d’un élément MappingGroup.

sep-str

Facultatif. Spécifie la chaîne de séparation lorsque base-path correspond à plusieurs nœuds XML.

Valeur par défaut : un seul espace.

pre-str

Facultatif. Spécifie une chaîne à ajouter au début du contenu extrait.

Valeur par défaut : une chaîne vide.

post-str

Facultatif. Spécifie une chaîne à ajouter à la fin du contenu extrait.

Valeur par défaut : une chaîne vide.

rec-sep-str

Facultatif. Spécifie le séparateur de chaînes à utiliser entre les contenus de chaque élément Mapping du groupe.

Valeur par défaut : un seul espace.

rec-pre-str

Facultatif. Spécifie une chaîne à ajouter au début du premier élément Mapping du groupe.

rec-post-str

Facultatif. Spécifie une chaîne à ajouter à la fin du dernier élément Mapping du groupe.

select

Facultatif. Définit les éléments Mapping dont le contenu doit être récupéré.

Valeur par défaut : merge

mode

Facultatif. Définit le comportement lorsqu’un autre élément Mapping ou MappingGroup inclut du contenu mappé au même nom de propriété.

Valeur par défaut : append

Attributs

Valeur

Description

merge

Fusionne le contenu de tous les éléments à l’aide des attributs rec-sep-str, rec-pre-str et rec-post-str.

first

Obtient le contenu du premier élément ayant un contenu.

longest

Obtient le contenu de l’élément ayant le contenu le plus long.

Attributs

Valeur

Description

append

Ajoute le nouveau contenu à la fin du contenu existant.

prepend

Ajoute le nouveau contenu au début du contenu existant.

overwrite

Remplace le contenu existant.

Éléments enfants

Élément

Description

Mapping

Mappe une expression XPath à une propriété analysée.

Éléments parents

Élément

Description

XMLMappings

Spécifie un jeu de mappages entre les expressions XPath et les propriétés analysées.

Exemple

La première section de code fournit un exemple d’entrée XML. La seconde section de code fournit une configuration de mappeur XML associé qui inclut deux expressions Mapping dans MappingGroup.

<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>

Cet exemple produit une propriété analysée dont la valeur est funny,hilarious.

Voir aussi

Concepts

Traitement d’élément XML personnalisé

XML Mapper, schéma