ContactsView

Статья
03/29/2023

Элемент ContactsView определяет поиск элементов контактов на основе отображаемых имен в алфавитном порядке.

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

ContactsViewType

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

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
MaxEntriesReturned	Описывает максимальное количество результатов, возвращаемых в ответе FindItem .
InitialName	Определяет имя в списке контактов, возвращаемого в ответе. Если указанное начальное имя отсутствует в списке контактов, будет возвращено следующее алфавитное имя, определенное в контексте языка и региональных параметров, за исключением случаев, когда следующее имя приходит после FinalName. Если атрибут InitialName опущен, ответ будет содержать список контактов, который начинается с имени в списке контактов. Этот атрибут является необязательным.
FinalName	Определяет фамилию в списке контактов, возвращаемую в ответе. Если атрибут FinalName опущен, ответ будет содержать все последующие контакты в указанном порядке сортировки. Если указанное окончательное имя отсутствует в списке контактов, будет исключено следующее алфавитное имя, определенное контекстом языка. Например, если FinalName="Name", но имя отсутствует в списке контактов, контакты с отображаемыми именами Name1 или NAME не будут включены. Этот атрибут является необязательным.

Дочерние элементы

Нет.

Родительские элементы

Элемент	Описание
FindItem	Определяет запрос на поиск элементов в почтовом ящике. Ниже приведено выражение XPath к этому элементу: `/FindItem`

Замечания

Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере с MicrosoftExchange Server 2007 и установленной ролью сервера клиентского доступа.

Пример

В следующем примере запроса показано, как найти первые три контакта, начиная с контакта с отображаемым именем 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
Файл проверки	Messages.xsd
Может быть пустым	False

Поделиться через