контактсвиевContactsView

Элемент контактсвиев определяет Поиск элементов контакта в соответствии с отображаемыми именами в алфавитном порядке.The ContactsView element defines a search for contact items based on alphabetical display names.

FindItemFindItem

контактсвиевContactsView

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

контактсвиевтипеContactsViewType

Атрибуты и элементыAttributes and elements

В следующих разделах описываются атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
максентриесретурнедMaxEntriesReturned
Описывает максимальное число результатов, возвращаемых в ответе FindItem .Describes the maximum number of results to return in the FindItem response.
инитиалнамеInitialName
Определяет первое имя в списке контактов для возврата в ответе.Defines the first name in the contacts list to return in the response. Если указанное начальное имя отсутствует в списке Contacts (контакты), будет возвращено следующее буквенное имя, заданное культурным контекстом, за исключением случаев, когда следующее имя предшествует финалнаме.If the specified initial name is not in the contacts list, the next alphabetical name as defined by the cultural context will be returned, except if the next name comes after FinalName. Если атрибут инитиалнаме опущен, ответ будет содержать список контактов, начинающихся с первого имени в списке контактов.If the InitialName attribute is omitted, the response will contain a list of contacts that starts with the first name in the contact list. Этот атрибут является необязательным.This attribute is optional.
финалнамеFinalName
Определяет фамилию в списке контактов, возвращаемой в ответе.Defines the last name in the contacts list to return in the response. Если атрибут финалнаме опущен, ответ будет содержать все последующие контакты в указанном порядке сортировки.If the FinalName attribute is omitted, the response will contain all subsequent contacts in the specified sort order. Если указанное итоговое имя отсутствует в списке Contacts (контакты), то следующее буквенное имя, заданное культурным контекстом, будет исключено.If the specified final name is not in the contacts list, the next alphabetical name as defined by the cultural context will be excluded.

Например, если Финалнаме = "Name", но имя отсутствует в списке Contacts (контакты), то контакты, у которых отображаются имена Имя1 или NAME, не будут включены.For example, if FinalName="Name", but Name is not in the contacts list, contacts that have display names of Name1 or NAME will not be included.

Этот атрибут является необязательным.This attribute is optional.

Дочерние элементы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

ПримечанияRemarks

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере с MicrosoftExchange Server 2007 и установленной ролью сервера клиентского доступа.The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.

ПримерExample

В приведенном ниже примере запроса показано, как найти первые три контакта, начиная с контакта с отображаемым именем Kelly.The following example of a request demonstrates how to find the first three contacts starting with the contact that has the display name of 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="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="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>

Сведения об элементеElement information

Пространство именNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Имя схемыSchema Name
Схема MessagesMessages schema
Файл проверкиValidation File
Messages. xsdMessages.xsd
Может быть пустымCan be Empty
FalseFalse

См. такжеSee also