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


Элемент Where (Query)

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения

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

<Where>
</Where>

Атрибуты

Атрибут

Описание

Нет

Нет

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

And, BeginsWith, Contains, DateRangesOverlap, Eq, Geq, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Membership, Neq, NotIncludes, Or

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

Expr1, Expr2, Query

Вхождения

Минимум: 0

Максимум: 1

Примечания

Предложение Where аналогично инструкции SQL SELECT. Формат предложения Where представляет собой дерево XML, состоящее из операторов сравнения, простых арифметических операторов, ссылок на поля (столбцы), постоянных значений и предопределенных констант языка Collaborative Application Markup Language (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>