Where element (Query)
Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Used within the context of a query to specify a filter.
Elements and attributes
The following sections describe attributes, child elements, and parent elements.
- Minimum: 0
- Maximum: 1
The Where clause translates into the SQL SELECT statement. The format of the Where clause is a structured XML tree with a mixture of comparison operators, simple arithmetic operators, field (column) references, constant values, and predefined Collaborative Application Markup Language (CAML) constants.
Fields referenced in a Where element do not have to be fields of the primary list that is being queried. If a foreign list is being joined, fields from the foreign list can be itemized in a ProjectedFields element and can then be referenced in the Where element.
In the following example, the Where element uses the Geq element as the filter in the query, returning cases where the date and time value in the Expires field is greater than today's date and time.
<Query> <Where> <Geq> <FieldRef Name="Expires"/> <Value Type="DateTime"> <Today/> </Value> </Geq> </Where> <OrderBy> <FieldRef Name="Modified"/> </OrderBy> </Query>