ContactsViewContactsView

L’élément ContactsView définit une recherche d’éléments de contact en fonction des noms d’affichage alphabétiques.The ContactsView element defines a search for contact items based on alphabetical display names.

FindItemFindItem

ContactsViewContactsView

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

ContactsViewTypeContactsViewType

Attributs et élémentsAttributes and elements

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
MaxEntriesReturnedMaxEntriesReturned
Décrit le nombre maximal de résultats à renvoyer dans la réponse FindItem .Describes the maximum number of results to return in the FindItem response.
InitialNameInitialName
Définit le premier nom de la liste de contacts à renvoyer dans la réponse.Defines the first name in the contacts list to return in the response. Si le nom d’origine spécifié ne figure pas dans la liste de contacts, le nom alphabétique suivant défini par le contexte culturel est renvoyé, sauf si le nom suivant vient après 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. Si l’attribut InitialName est omis, la réponse contient une liste de contacts qui commence par le prénom dans la liste des contacts.If the InitialName attribute is omitted, the response will contain a list of contacts that starts with the first name in the contact list. Cet attribut est facultatif.This attribute is optional.
FinalNameFinalName
Définit le nom de famille de la liste de contacts à renvoyer dans la réponse.Defines the last name in the contacts list to return in the response. Si l’attribut FinalName est omis, la réponse contiendra tous les contacts suivants dans l’ordre de tri spécifié.If the FinalName attribute is omitted, the response will contain all subsequent contacts in the specified sort order. Si le nom final spécifié ne figure pas dans la liste de contacts, le nom alphabétique suivant défini par le contexte culturel est exclu.If the specified final name is not in the contacts list, the next alphabetical name as defined by the cultural context will be excluded.

Par exemple, si FinalName = « nom », mais que le nom ne figure pas dans la liste de contacts, les contacts dont le nom d’affichage est « name1 » ne seront pas inclus.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.

Cet attribut est facultatif.This attribute is optional.

Éléments enfantsChild elements

Aucun.None.

Éléments parentsParent elements

ÉlémentElement DescriptionDescription
FindItemFindItem
Définit une requête pour rechercher des éléments dans une boîte aux lettres.Defines a request to find items in a mailbox.

Voici l’expression XPath de cet élément :The following is the XPath expression to this element:
/FindItem

RemarquesRemarks

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

ExempleExample

L’exemple de requête suivant montre comment rechercher les trois premiers contacts en commençant par le contact dont le nom d’affichage est Barbara Mayer.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>

Informations sur l'élémentElement information

Espace de nomsNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
Nom du schémaSchema Name
Schéma MessagesMessages schema
Fichier de validationValidation File
Messages. xsdMessages.xsd
Peut être videCan be Empty
FalseFalse

Voir aussiSee also