Élément Joins (Afficher)

Article
09/24/2014

Dernière modification : jeudi 19 novembre 2009

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

Contient les éléments de jointure nécessaires pour une requête.

<Joins>  <Join ... >  </Join>    <Join ... >  </Join>  ...</Joins>

Attributs

Attribut	Description
Aucun	N/A

Éléments enfants

Join

Éléments parents

View

Notes

Lorsqu’un élément Joins est utilisé en tant que composant d’une requête dynamique au lieu d’être utilisé en tant que composant de la définition d’un affichage de liste, c’est-à-dire lorsqu’il est la valeur de la propriété SPQuery.Joins et pas la valeur de la propriété Joins, il n’a pas vraiment d’élément parent.

Occurrences

Minimum : 0

Maximum : 1

Exemple

Voici un exemple de d’un élément Joins avec deux jointures externes gauches. CustomerName est un champ de recherche sur une liste Orders. Il recherche le champ ID d’une liste Customers. La liste Customer a à son tour un champ CityName qui est un champ de recherche pour une liste Cities. Le premier élément Join attribue le nom « customers » en tant qu’alias à la liste Customers. L’enfant de l’élément Eq définit la jointure en utilisant les mêmes champs source et cible qui constituent la relation de recherche. Le deuxième élément Join attribue le nom « customerCities » en tant qu’alias à la liste Cities. Il définit la jointure parallèlement à la relation de recherche existante entre les listes Customer et Cities.

Les alias sont nécessaires pour les listes car il peut exister plusieurs jointures sur la même liste et des alias différents sont alors nécessaires pour différencier les jointures. Par exemple, en plus des jointures de Orders avec Customer et de Customer avec Cities, il pourrait également y avoir des jointures de Orders avec Suppliers et de Suppliers avec Cities. Dans le cas de la dernière jointure, un autre alias, par exemple « supplierCities » serait attribué à la liste Cities, alias qui serait différent de celui utilisé pour la jointure de Customer avec Cities.

<Joins>
  <Join Type=’LEFT’ ListAlias=’customers’>
    <Eq>
      <FieldRef Name=’CustomerName’ RefType=’Id’ />
      <FieldRef List=’customers’ Name=’ID’ />
    </Eq>
  </Join>

  <Join Type=’LEFT’ ListAlias=’customerCities’>
    <Eq>
      <FieldRef List=’customer’ Name=’CityName’ RefType=’Id’ />
      <FieldRef List=’customerCities’ Name=’ID’ />
    </Eq>
  </Join>
</Joins>

Partager via