Элемент Where (Query)

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Используется внутри контекста запроса для указания фильтра.

<Where>
</Where>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Нет

Дочерние элементы

• And
• BeginsWith
• Contains
• DateRangesOverlap
• Эквалайзер
• Geq
• Gt
• Куда включается
• Включает в себя
• IsNotNull
• IsNull
• Leq
• Lt
• Членство.
• Нек
• NotIncludes
• Or

Родительские элементы

• Expr1
• Expr2
• Query

Occurrences

• Минимум: 0
• Максимум: 1

Замечания

Оператор Where аналогичен оператору SQL SELECT. Формат предложения Where представляет собой структурированное дерево XML со смесью операторов сравнения, простых арифметических операторов, ссылок на поля (столбцы), константных значений и предопределенных констант CAML.

Поля, на которые ссылается элемент Where, не обязательно должны быть полями запрашиваемого первичного списка. При соединении внешнего списка поля из внешнего списка можно элементизировать в элементе ProjectedFields , а затем ссылаться в элементе Where .

Пример

В приведенном ниже примере элемент Where использует элемент Geq в качестве фильтра для запроса, который возвращает те случаи, в которых значение даты и времени в поле Expires больше текущей даты и времени.

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