Where-Element (Abfrage)

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Wird im Kontext einer Abfrage zum Angeben eines Filters verwendet.

<Where>
</Where>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Keine

Untergeordnete Elemente

• Und
• BeginsWith
• Contains
• DateRangesOverlap
• Eq
• Geq
• Gt
• In
• Inhalt
• IsNotNull
• IsNull
• Leq
• Lt
• Mitgliedschaft
• Neq
• NotIncludes
• Or

Übergeordnete Elemente

• Expr1
• Expr2
• Query

Vorkommen

• Minimum: 0
• Maximum: 1

Hinweise

Die Where-Klausel entspricht der SQL-Anweisung SELECT. Das Format der Where-Klausel ist eine strukturierte XML-Struktur mit einer Mischung aus Vergleichsoperatoren, einfachen arithmetischen Operatoren, Feldverweisen (Spalten),Konstantenwerten und vordefinierten CAML-Konstanten (Collaborative Application Markup Language).

Felder, auf die in einem Where-Element verwiesen wird, müssen keine Felder der primären Liste sein, die abgefragt wird. Wenn eine fremde Liste verknüpft wird, können Felder aus der Fremdliste in einem ProjectedFields-Element zugeordnet und dann im Where-Element referenziert werden.

Beispiel

Im folgenden Beispiel verwendet das Where-Element das Geq-Element als Filter in der Abfrage, sodass Fälle zurückgegeben werden, für die der Datums- und Uhrzeitwert im Expires-Feld größer als das aktuelle Datum und die aktuelle Uhrzeit ist.

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