Where-Element (Abfrage)

Artikel
09/24/2014

Letzte Änderung: Freitag, 16. April 2010

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen

Wird im Kontext einer Abfrage zum Angeben eines Filters verwendet.

<Where>
</Where>

Attribute

Attribut	Beschreibung
Keine	n/v

Untergeordnete Elemente

And, BeginsWith, Contains, DateRangesOverlap, Eq, Geq, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Membership, 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 ein strukturierter XML-Baum mit einer Mischung aus Vergleichsoperatoren, einfachen arithmetischen Operatoren, Feld- (Spalten-)verweisen, konstanten Werten und vordefinierten Collaborative Application Markup Language (CAML)-Konstanten.

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 fremden Liste in einem ProjectedFields-Element einzeln aufgelistet werden, und es kann dann im Where-Element auf sie verwiesen 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>

Freigeben über