通过

ContactsView

  • 项目

ContactsView 元素根据字母顺序显示名称定义联系人项搜索。

FindItem

ContactsView

<ContactsView MaxEntriesReturned="" InitialName="" FinalName="" />

ContactsViewType

属性和元素

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

Attributes

属性 说明
MaxEntriesReturned
描述在 FindItem 响应中返回的最大结果数。
InitialName
定义联系人列表中要在响应中返回的名字。 如果指定的初始名称不在联系人列表中，则将返回区域性上下文定义的下一个字母名称，除非下一个名称位于 FinalName 之后。 如果省略 InitialName 属性，响应将包含以联系人列表中名字开头的联系人列表。 此特性是可选的。
FinalName
定义联系人列表中要在响应中返回的姓氏。 如果省略 FinalName 属性，则响应将包含指定排序顺序中的所有后续联系人。 如果指定的最终姓名不在联系人列表中，则将排除区域性上下文定义的下一个字母顺序名称。

例如，如果 FinalName=“Name”，但名称不在联系人列表中，则不会包括显示名称为 Name1 或 NAME 的联系人。

此特性是可选的。

子元素

无。

父元素

元素 说明
FindItem
定义在邮箱中查找项目的请求。

下面是此元素的 XPath 表达式：
/FindItem

备注

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

示例

以下请求示例演示如何查找以显示名称为 Kelly Rollin 的联系人开头的前三个联系人。

<?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="contacts:DisplayName"/>
        </t:AdditionalProperties>
      </ItemShape>
      <ContactsView MaxEntriesReturned="3" InitialName="Kelly Rollin" />
      <SortOrder>
        <t:FieldOrder Order="Descending">
          <t:FieldURI FieldURI="contacts:DisplayName"/>
        </t:FieldOrder>
        </SortOrder>
      <ParentFolderIds>
        <t:DistinguishedFolderId Id="contacts"/>
      </ParentFolderIds>
    </FindItem>
  </soap:Body>
</soap:Envelope>

元素信息

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

另请参阅