Compartilhar via


ContactsView

O elemento ContactsView define uma pesquisa de itens de contato com base em nomes de exibição alfabéticos.

FindItem

ContactsView

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

ContactsViewType

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo Descrição
MaxEntriesReturned
Descreve o número máximo de resultados a serem retornados na resposta FindItem .
InitialName
Define o primeiro nome na lista de contatos a ser retornado na resposta. Se o nome inicial especificado não estiver na lista de contatos, o próximo nome alfabético definido pelo contexto cultural será retornado, exceto se o próximo nome vier após FinalName. Se o atributo InitialName for omitido, a resposta conterá uma lista de contatos que começa com o primeiro nome na lista de contatos. Esse atributo é opcional.
FinalName
Define o sobrenome na lista de contatos a ser retornado na resposta. Se o atributo FinalName for omitido, a resposta conterá todos os contatos subsequentes na ordem de classificação especificada. Se o nome final especificado não estiver na lista de contatos, o próximo nome alfabético, conforme definido pelo contexto cultural, será excluído.

Por exemplo, se FinalName="Name", mas Name não estiver na lista de contatos, os contatos que tiverem nomes de exibição de Name1 ou NAME não serão incluídos.

Esse atributo é opcional.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
FindItem
Define uma solicitação para encontrar itens em uma caixa de correio.

A seguir está a expressão XPath para esse elemento:
/FindItem

Comentários

O esquema que descreve este elemento está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem instalada a função de servidor de Acesso para Cliente.

Exemplo

O exemplo a seguir de uma solicitação demonstra como encontrar os três primeiros contatos começando com o contato que tem o nome de exibição de 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>

Elemento de informações

Elemento Exemplo
Namespace
http://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema
Esquema de mensagens
Arquivo de validação
Messages.xsd
Pode ser vazio
False

Confira também