ContactsView

Article
03/29/2023

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

<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="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>

Informations sur l'élément

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

Partager via