Элемент Where (Query)

Статья
04/08/2023

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

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

<Where>
</Where>

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

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

Атрибуты

Нет

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

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

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>

Поделиться через