Where, élément (Query)

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

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

<Where>
</Where>

Éléments et attributs

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

Attributs

Aucun

Éléments enfants

Éléments parents

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 champ (colonne), de valeurs constantes et de constantes CAML (Collaborative Application Markup Language) prédéfinies.

Les champs référencés dans un élément Where ne doivent pas être des champs de la liste primaire en cours d’interrogation. Si une liste étrangère est jointe, les champs de la liste étrangère peuvent être inclus dans un élément ProjectedFields et peuvent ensuite ê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>