GroupByGroupBy

GroupBy元素指定 FindItem 查询的任意分组。The GroupBy element specifies an arbitrary grouping for FindItem queries.

<GroupBy Order="">
   <FieldURI/>
   <AggregateOn/>
</GroupBy>
<GroupBy Order="">
   <ExtendededFieldURI/>
   <AggregateOn/>
</GroupBy>
<GroupBy Order="">
   <IndexedFieldURI/>
   <AggregateOn/>
</GroupBy>

GroupByTypeGroupByType

属性和元素Attributes and elements

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

AttributesAttributes

属性Attribute 说明Description
OrderOrder
确定在响应中返回的分组项数组中组的顺序。Determines the order of the groups in the grouped item array that is returned in the response. 此属性的类型为 SortDirectionType。This attribute is of type SortDirectionType.

顺序属性值Order attribute values

Value 说明Description
升序Ascending
组按升序排列。The groups are ordered in ascending order.
降序Descending
组按降序排列。The groups are ordered in descending order.

子元素Child elements

元素Element 描述Description
FieldURIFieldURI
标识由 URI 频繁引用的属性。Identifies frequently referenced properties by URI.
IndexedFieldURIIndexedFieldURI
标识词典中的各个成员。Identifies individual members of a dictionary.
ExtendedFieldURIExtendedFieldURI
标识要获取、设置或创建的扩展 MAPI 属性。Identifies extended MAPI properties to get, set, or create.
AggregateOnAggregateOn
表示用于确定响应中的组顺序的字段。Represents the field that is used to determine the order of groups in a response.

父元素Parent elements

元素Element 描述Description
FindItemFindItem
定义在邮箱中查找项目的请求。Defines a request to find items in a mailbox.

下面是此元素的 XPath 表达式: /FindItemThe following is the XPath expression to this element: /FindItem

备注Remarks

FindItem 响应将包含组的集合。The FindItem response will contain a collection of groups. 每个组将包含具有GroupBy属性的匹配值的所有项目。Each group will contain all items that had matching values for the GroupBy property. 确定分组的属性在FieldURIIndexedFieldURIExtendedFieldURI元素中进行标识。The property that determines the grouping is identified in the FieldURI, IndexedFieldURI, or ExtendedFieldURI element.

描述此元素的架构位于正在运行 Microsoft Exchange Server 2007 的计算机(已安装客户端访问服务器角色)的 EWS 虚拟目录中。The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

元素信息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