IndexedPageItemView

  • 项目

IndexedPageItemView 元素描述如何为 FindItem 操作或 FindConversation 操作请求返回分页对话或项信息。

<IndexedPageViewItemView MaxEntriesReturned="" Offset="" BasePoint=""/>

IndexedPageViewType

属性和元素

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

Attributes

属性 说明
MaxEntriesReturned
描述响应中要返回的最大项目或对话数。 此特性是可选的。
Offset
描述与 BasePoint 的偏移量。 如果 BasePoint 等于“开始”，则偏移量为正。 如果 BasePoint 等于 End，则处理偏移量，就像是负数一样。 这标识将在响应中首先传递的项或对话。 此特性是必需的。
BasePoint
描述项目或对话页是从使用搜索条件找到的一组项或对话的开头还是末尾开始。 从末尾查找始终向后搜索。 此特性是必需的。

BasePoint 属性

值 说明
开始
 分页视图从找到的对话或项目集的开头开始。
End
 分页视图从找到的对话或项目集的末尾开始。

子元素

无。

父元素

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

备注

从末尾查找涉及移动到由偏移标识的原点。 此外，指针会按请求的记录数移回。 例如，如果有 100 条记录，并且距末尾的偏移量为 25，则搜索将从 75 开始。 如果返回 10 条记录，则指针向后移动 10 条记录到 65 条，并返回记录 65 到 75 条。 下一个索引为 64。 页面末尾的下一个偏移量是 100 减去 64，等于 36。 36 是从末尾开始的下一个偏移量的值，用于获取下一个索引页。

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。

示例

以下示例显示了 FindItem 操作 请求。 返回每个项目及其 ID 和主题。 响应中最多返回六个项，由 MaxEntriesReturned 属性指定。 这些项按重要性按升序列出。 组中的项按主题聚合。

<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>
      <IndexedPageItemView MaxEntriesReturned="6" BasePoint="Beginning" Offset="0" />
      <GroupBy Order="Ascending">
        <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>

元素信息

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

另请参阅

FindItem 操作

FindConversation 操作

查找项