SPQuery.Joins - Propriété
Obtient ou définit la section de l'élément de jointures de la requête, y compris tous ses éléments enfants.
Espace de noms : Microsoft.SharePoint
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
Public Property Joins As String
Get
Set
'Utilisation
Dim instance As SPQuery
Dim value As String
value = instance.Joins
instance.Joins = value
public string Joins { get; set; }
Valeur de propriété
Type : System.String
L'élément joint XML.
Remarques
Chaque jointure est représenté par un jointure élément enfant de l'élément de jointures . Uniquement les jointures externes gauche et internes sont autorisés. En outre, le champ dans la liste principale doit être un champ de type liste de choix qui effectue une recherche dans le champ de la liste externe. Il peut y avoir jointures à plusieurs listes de jointures multiples à la même liste et des chaînes de jointures. Si une liste donnée est la liste dans plus d'une jointure externe, il doit avoir des alias distincts qui lui est assignées par les attributs ListAlias des éléments de jointure représentant les jointures.
Exemples
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 utiles 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=’customers’ Name=’CityName’ RefType=’Id’ />
<FieldRef List=’customerCities’ Name=’ID’ />
</Eq>
</Join>
</Joins>