ContactsViewContactsView

O elemento ContactsView define uma pesquisa para itens de contato com base em nomes de exibição em ordem alfabética.The ContactsView element defines a search for contact items based on alphabetical display names.

FindItemFindItem

ContactsViewContactsView

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

ContactsViewTypeContactsViewType

Atributos e elementosAttributes and elements

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
MaxEntriesReturnedMaxEntriesReturned
Descreve o número máximo de resultados a serem retornados na resposta FindItem .Describes the maximum number of results to return in the FindItem response.
InitialnameInitialName
Define o primeiro nome na lista de contatos a ser retornado na resposta.Defines the first name in the contacts list to return in the response. Se o nome inicial especificado não estiver na lista de contatos, o próximo nome da ordem alfabética definido pelo contexto cultural será retornado, exceto se o próximo nome vier após o finalname.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. Se o atributo inicialname for omitido, a resposta conterá uma lista de contatos que inicia com o primeiro nome na lista de contatos.If the InitialName attribute is omitted, the response will contain a list of contacts that starts with the first name in the contact list. Esse atributo é opcional.This attribute is optional.
FinalnameFinalName
Define o último nome na lista de contatos para retornar na resposta.Defines the last name in the contacts list to return in the response. Se o atributo finalname for omitido, a resposta conterá todos os contatos subsequentes na ordem de classificação especificada.If the FinalName attribute is omitted, the response will contain all subsequent contacts in the specified sort order. Se o nome final especificado não estiver na lista de contatos, o nome da próxima ordem alfabética definido pelo contexto cultural será excluído.If the specified final name is not in the contacts list, the next alphabetical name as defined by the cultural context will be excluded.

Por exemplo, se Finalname = "Name", mas Name não estiver na lista de contatos, os contatos com nomes de exibição de Nome1 ou NAME não serão incluídos.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.

Esse atributo é opcional.This attribute is optional.

Elementos filhoChild elements

Nenhum.None.

Elementos paiParent elements

ElementoElement DescriçãoDescription
FindItemFindItem
Define uma solicitação para localizar itens em uma caixa de correio.Defines a request to find items in a mailbox.

A seguir está a expressão XPath para este elemento:The following is the XPath expression to this element:
/FindItem

ComentáriosRemarks

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.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.

ExemploExample

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

Elemento de informaçõesElement information

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquemaSchema Name
Esquema de mensagensMessages schema
Arquivo de validaçãoValidation File
Messages.xsdMessages.xsd
Pode ser vazioCan be Empty
FalseFalse

Confira tambémSee also