FractionalPageItemView

Элемент FractionalPageItemView описывает, где начинается страничное представление и максимальное количество элементов, возвращаемых в запросе FindItem .

FindItem

FractionalPageItemView

<FractionalPageItemView MaxEntriesReturned="" Numerator="" Denominator=""/>

FractionalPageViewType

Атрибуты и элементы

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

Атрибуты

Атрибут	Описание
MaxEntriesReturned	Определяет максимальное количество результатов, возвращаемых в ответе FindItem . Этот атрибут является необязательным. Если этот атрибут не указан, вызов вернет все доступные элементы.
Числитель	Представляет числитель дробного смещения от начала результирующих наборов. Этот атрибут является обязательным. Числитель должен быть равен или меньше знаменателя. Этот атрибут должен представлять целочисленное значение, равное нулю или больше. Дополнительные сведения см. в разделе Примечания далее в этом разделе.
Знаменатель	Представляет знаменатель дробного смещения от начала общего числа элементов в результирующем наборе. Этот атрибут является обязательным. Этот атрибут должен представлять целочисленное значение больше единицы. Дополнительные сведения см. в разделе Примечания далее в этом разделе.

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

Нет.

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

Элемент	Описание
FindItem	Определяет запрос на поиск элементов в почтовом ящике. Ниже приведено выражение XPath к этому элементу: /FindItem

Замечания

Смещение постраничного представления от начала набора найденных элементов описывается дробью. Дробь, определяемая атрибутами числителя и знаменателя , описывает, с чего начинается страница сведений. Например, если числитель равен четырем, а знаменатель равен пяти, страница возвращаемых сведений начинается с записи, расположенной четыре пятых пути в результирующий набор.

Если дробь равна нулю, это указывает на начало набора результатов. Если дробь вычисляется до единицы, это указывает конец результирующих наборов.

Примечание.

Дробь представляет начальную точку страницы, а не количество результатов в результирующем наборе.

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере с MicrosoftExchange Server 2007 и установленной ролью сервера клиентского доступа.

Пример

В следующем примере показан запрос FindItem . Запрос возвращает элементы из результатов поиска, которые начинаются после второй трети всех элементов в результирующем наборе.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ItemShape>
        <t:BaseShape>IdOnly</t:BaseShape>
        <t:AdditionalProperties>
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AdditionalProperties>
      </ItemShape>
      <FractionalPageItemView MaxEntriesReturned="12" Numerator="2" Denominator="3"/>
      <GroupBy Order="Descending">
        <t:FieldURI FieldURI="item:Importance"/>
        <t:AggregateOn Aggregate="Maximum">
          <t:FieldURI FieldURI="item:Subject"/>
        </t:AggregateOn>
      </GroupBy>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

Например, если результирующий набор содержит девять элементов, выстраивное представление вернет до 12 элементов, начиная с элемента, найденного две трети пути в результирующем наборе. В этом случае страница начинается с седьмого элемента. Страница будет содержать седьмой, восьмой и девятый элементы. Если числитель равен нулю, представление страницы вернет все элементы в результирующем наборе при условии, что число меньше атрибута MaxEntriesReturned .

Сведения об элементе

Элемент	Пример
Пространство имен	https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемы	Схема Messages
Файл проверки	Messages.xsd
Может быть пустым	False

См. также

FindItem Operation

Поиск элементов