Where, élément (Query)

Article
09/24/2014

Dernière modification : vendredi 16 avril 2010

S’applique à : SharePoint Foundation 2010

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

Utilisé dans le contexte d'une requête pour spécifier un filtre.

<Where>
</Where>

Attributs

Attribut	Description
Aucun	N/A

Éléments enfants

And, BeginsWith, Contains, DateRangesOverlap, Eq, Geq, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Membership, Neq, NotIncludes, Or

Éléments parents

Expr1, Expr2, Query

Occurrences

Minimum : 0

Maximum : 1

Remarques

La clause Where se traduit en instruction SQL SELECT. Le format de la clause Where est une arborescence XML structurée avec un mélange d’opérateurs de comparaison, d’opérateurs arithmétiques simples, de références de champs (colonnes), de valeurs constantes et de constantes prédéfinies (Langage CAML (Collaborative Application Markup Language)).

Il n’est pas nécessaire que les champs référencés dans un élément Where soient des champs de la liste principale en cours d’interrogation. Si une liste étrangère est jointe, les champs de celle-ci peuvent être détaillés dans un élément ProjectedFields, puis être référencés dans l’élément Where.

Exemple

Dans l'exemple suivant, l'élément Where utilise l'élément Geq comme filtre dans la requête et renvoie les cas pour lesquels la valeur de date et d'heure du champ Expires est postérieure à la date et à l'heure d'aujourd'hui.

<Query>
  <Where>
    <Geq>
      <FieldRef Name="Expires"/>
      <Value Type="DateTime">
        <Today/>
      </Value>
    </Geq>
  </Where>
  <OrderBy>
    <FieldRef Name="Modified"/>
  </OrderBy>
</Query>

Share via