ContactsView
O elemento ContactsView define uma pesquisa de itens de contato com base em nomes de exibição alfabéticos.
<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 |