And, élément (Query)

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

Utilisé dans l'élément Where pour regrouper des filtres dans une requête en vue d'un affichage.

<And>
</And>

É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

• And
• BeginsWith
• Contains
• DateRangesOverlap
• Eq
• Geq
• Gt
• Dans
• Contenu
• IsNotNull
• IsNull
• Leq
• Lt
• Appartenance
• Neq
• NotIncludes
• Or

Éléments parents

• And
• Or
• Where

Occurrences

• Minimum : 0
• Maximum : pas de limite

Remarques

Cet élément peut être imbriqué dans d’autres éléments And et Or. Le serveur prend en charge les requêtes complexes illimitées. Cependant, tout élément And ne peut avoir que deux conjonctions ; c’est-à-dire, seulement deux éléments enfants. Si vous devez conjoindre trois conditions ou plus, vous devez imbriquer les éléments And, comme illustré par le troisième exemple dans la section suivante.

Exemples

L'exemple suivant présente les critères d'une requête sur le champ ProductID : (ProductID = J1539 AND ProductID = J9862) AND (ProductID = J0394 OR ProductID = J4589).

<And>
  <And>
    <Eq>
      <FieldRef Name="ProductID"/>
      <Value Type="Text">J1539</Value>
    </Eq>
    <Eq>
      <FieldRef Name="ProductID"/>
      <Value Type="Text">J9862</Value>
    </Eq>
  </And>
  <Or>
    <Eq>
      <FieldRef Name="ProductID"/>
      <Value Type="Text">J0394</Value>
    </Eq>
    <Eq>
      <FieldRef Name="ProductID"/>
      <Value Type="Text">J4589</Value>
    </Eq>
  </Or>
</And>

L'exemple suivant exécute une requête lorsque des valeurs du champ Status ne sont pas égales à Terminé et lorsque des valeurs du champ Sent sont null. Les enregistrements renvoyés sont triés dans l'ordre croissant conformément aux valeurs du champ Modified.

<Query>
  <OrderBy>
    <FieldRef Name="Modified" Ascending="FALSE"></FieldRef>
  </OrderBy>
  <Where>
    <And>
      <Neq>
        <FieldRef Name="Status"></FieldRef>
        <Value Type="Text">Completed</Value>
      </Neq>
      <IsNull>
        <FieldRef Name="Sent"></FieldRef>
      </IsNull>
    </And>
  </Where>
</Query>

L’exemple suivant montre comment conjoindre trois conditions. Notez que la première paire de conditions se trouve dans leur propre élément And , qui est lui-même une condition d’un élément And externe.

<Where>
  <And>
    <And>
      <Eq><FieldRef Name="LastName" />
        <Value Type="Text">Bagel</Value>
      </Eq>
      <Eq><FieldRef Name="FirstName" />
        <Value Type="Text">Jean</Value>
      </Eq>
    </And>
    <Includes>
      <FieldRef Name="Title" /><Value Type="Text">President</Value>
    </Includes>
  </And>
</Where>