FractionalPageItemView

FractionalPageItemView 元素描述分页视图的开始位置，以及 FindItem 请求中返回的最大项数。

FindItem

FractionalPageItemView

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

FractionalPageViewType

属性和元素

下面各部分介绍了属性、子元素和父元素。

Attributes

属性	说明
MaxEntriesReturned	标识 FindItem 响应中要返回的最大结果数。 此特性是可选的。 如果未指定此属性，则调用将返回所有可用项。
分子	表示结果集开头的小数偏移量的分子。 此特性是必需的。 分子必须等于或小于分母。 此属性必须表示等于或大于零的整数值。 有关详细信息，请参阅本主题后面的备注。
分母	表示从结果集中项总数开始的小数偏移量的分母。 此特性是必需的。 此属性必须表示大于 1 的整数值。 有关详细信息，请参阅本主题后面的备注。

子元素

无。

父元素

元素	说明
FindItem	定义在邮箱中查找项目的请求。 下面是此元素的 XPath 表达式： /FindItem

备注

分页视图与找到的项集的开头的偏移量用分数描述。 由 分子 和 分母 属性定义的分数描述信息页的开始位置。 例如，如果 Numerator 等于 4 且 分母 等于 5，则返回信息的页面从位于结果集的五分之四的入口处开始。

如果分数的计算结果为零，则表示结果集的开头。 如果分数的计算结果为 1，则表示结果集的末尾。

注意

分数表示页面的起点，而不是结果集中将返回的结果数。

描述此元素的架构位于正在运行 MicrosoftExchange Server 2007 的计算机（已安装客户端访问服务器角色）的 EWS 虚拟目录中。

示例

以下示例显示了 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="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindItem Traversal="Shallow" xmlns="http://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>

例如，如果结果集包含 9 个项目，则分页视图将返回最多 12 个项目，从找到的项开始，结果集的三分之二。 在本例中，页面从第七项开始。 页面将包含第七项、第八项和第九项。 如果分子设置为零，则只要数字小于 MaxEntriesReturned 属性，页面视图将返回结果集中的所有项。

元素信息

元素	示例
命名空间	http://schemas.microsoft.com/exchange/services/2006/messages
架构名称	消息架构
验证文件	Messages.xsd
可以为空	False

另请参阅

FindItem 操作

查找项