Partager via


ContactsView

L’élément ContactsView définit une recherche d’éléments de contact basée sur des noms d’affichage alphabétiques.

FindItem

ContactsView

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

ContactsViewType

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
MaxEntriesReturned
Décrit le nombre maximal de résultats à retourner dans la réponse FindItem .
InitialName
Définit le prénom dans la liste de contacts à retourner dans la réponse. Si le nom initial spécifié ne figure pas dans la liste des contacts, le nom alphabétique suivant tel que défini par le contexte culturel est retourné, sauf si le nom suivant vient après FinalName. Si l’attribut InitialName est omis, la réponse contient une liste de contacts qui commence par le prénom dans la liste de contacts. Cet attribut est facultatif.
FinalName
Définit le nom de famille dans la liste de contacts à retourner dans la réponse. Si l’attribut FinalName est omis, la réponse contient tous les contacts suivants dans l’ordre de tri spécifié. Si le nom final spécifié ne figure pas dans la liste des contacts, le nom alphabétique suivant tel que défini par le contexte culturel est exclu.

Par exemple, si FinalName="Name », mais que Name ne figure pas dans la liste des contacts, les contacts dont le nom complet est Name1 ou NAME ne sont pas inclus.

Cet attribut est facultatif.

Éléments enfants

Aucun.

Éléments parents

Élément Description
FindItem
Définit une demande de recherche d’éléments dans une boîte aux lettres.

Voici l’expression XPath de cet élément :
/FindItem

Remarques

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel EWS de l'ordinateur qui exécute MicrosoftExchange Server 2007 pour lequel le rôle serveur d'accès au client est installé.

Exemple

L’exemple suivant d’une requête montre comment rechercher les trois premiers contacts en commençant par le contact portant le nom complet 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="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>

Informations sur l'élément

Élément Exemple
Espace de noms
https://schemas.microsoft.com/exchange/services/2006/messages
Nom du schéma
Schéma Messages
Fichier de validation
Messages.xsd
Peut être vide
False

Voir aussi