IndexedPageItemViewIndexedPageItemView

IndexedPageItemView元素介绍如何为FindItem 操作FindConversation 操作请求返回分页对话或项目信息。The IndexedPageItemView element describes how paged conversation or item information is returned for a FindItem operation or FindConversation operation request.

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

IndexedPageViewTypeIndexedPageViewType

属性和元素Attributes and elements

下面各部分介绍了属性、子元素和父元素。The following sections describe attributes, child elements, and parent elements.

AttributesAttributes

属性Attribute 说明Description
MaxEntriesReturnedMaxEntriesReturned
描述要在响应中返回的项目或对话的最大数量。Describes the maximum number of items or conversations to return in the response. 此特性是可选的。This attribute is optional.
OffsetOffset
描述BasePoint中的偏移量。Describes the offset from the BasePoint. 如果BasePoint等于开头,则偏移量为正值。If BasePoint is equal to Beginning, the offset is positive. 如果BasePoint等于 End,则处理的是负的偏移量。If BasePoint is equal to End, the offset is handled as if it were negative. 这标识在响应中将首先传递哪个项目或对话。This identifies which item or conversation will be the first to be delivered in the response. 此特性是必需的。This attribute is required.
BasePointBasePoint
描述项目或对话的页面是从使用搜索条件找到的项目或对话集的开头还是结尾开始。Describes whether the page of items or conversations will start from the beginning or the end of the set of items or conversations that are found by using the search criteria. 从末尾进行的查找始终向后搜索。Seeking from the end always searches backward. 此特性是必需的。This attribute is required.

BasePoint 属性BasePoint Attribute

Value 说明Description
Beginning
分页视图从找到的对话或项目集的开头开始。The paged view starts at the beginning of the found conversation or item set.
EndEnd
分页视图从找到的对话或项目集的末尾开始。The paged view starts at the end of the found conversation or item set.

子元素Child elements

无。None.

父元素Parent elements

元素Element 描述Description
FindItemFindItem
定义在邮箱中查找项目的请求。Defines a request to find items in a mailbox.
下面是此元素的 XPath 表达式: The following is the XPath expression to this element:
/FindItem
FindConversationFindConversation
定义在邮箱中查找对话的请求。Defines a request to find conversations in a mailbox.

备注Remarks

从末尾进行查找包括移到由偏移量标识的源。Seeking from the end involves moving to the origin identified by the offset. 此外,还会按请求的记录数向后移动指针。Additionally, the pointer is moved back by the number of requested records. 例如,如果有100条记录,偏移量是从末尾到25,则搜索从75开始。For example, if there are 100 records and the offset is 25 from the end, the search starts from 75. 如果返回10个记录,指针将向后移动10条记录到65,并返回记录65至75。If 10 records are returned, the pointer is moved backward an additional 10 records to 65 and returns records 65 through 75. 下一个索引为64。The next index is 64. 距页面末尾的下一个偏移量是100减去64,等于36。The next offset from the end for a page is 100 minus 64 which equals 36. 36是来自 end 的下一个偏移量的值,以获取下一个索引页。36 is the value for the next offset from the end to get the next indexed page.

描述此元素的架构位于承载 Exchange Web Services 的 IIS 虚拟目录中。The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

示例Example

下面的示例展示了一个FindItem 操作请求。The following example shows a FindItem operation request. 每个项目都返回其 ID 和主题。Each item is returned with its ID and subject. 响应中最多可返回6个项目,如MaxEntriesReturned属性指定。A maximum of six items are returned in the response, as specified by the MaxEntriesReturned attribute. 项目按重要性分组按升序排列。The items are listed in ascending order grouped by importance. 组中的项目按主题进行聚合。Items in a group are aggregated by subject.

<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>

元素信息Element information

命名空间Namespace
https://schemas.microsoft.com/exchange/services/2006/messages
架构名称Schema Name
消息架构Messages schema
验证文件Validation File
Messages.xsdMessages.xsd
可以为空Can be Empty
FalseFalse

另请参阅See also

FindItem 操作FindItem operation

FindConversation 操作FindConversation operation

查找项目Finding Items