ContactsView

Artikel
03/29/2023

Das ContactsView-Element definiert eine Suche nach Kontaktelementen basierend auf alphabetischen Anzeigenamen.

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

ContactsViewType

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
MaxEntriesReturned	Beschreibt die maximale Anzahl von Ergebnissen, die in der FindItem-Antwort zurückgegeben werden sollen.
InitialName	Definiert den Vornamen in der Kontaktliste, der in der Antwort zurückgegeben werden soll. Wenn der angegebene Anfangsname nicht in der Kontaktliste enthalten ist, wird der nächste alphabetische Name gemäß der Definition durch den kulturellen Kontext zurückgegeben, es sei denn, der nächste Name kommt nach FinalName. Wenn das InitialName-Attribut nicht angegeben wird, enthält die Antwort eine Liste von Kontakten, die mit dem Vornamen in der Kontaktliste beginnt. Dieses Attribut ist optional.
FinalName	Definiert den Nachnamen in der Kontaktliste, der in der Antwort zurückgegeben werden soll. Wenn das FinalName-Attribut nicht angegeben wird, enthält die Antwort alle nachfolgenden Kontakte in der angegebenen Sortierreihenfolge. Wenn der angegebene endgültige Name nicht in der Kontaktliste enthalten ist, wird der nächste alphabetische Name gemäß der Definition durch den kulturellen Kontext ausgeschlossen. Wenn z. B. FinalName="Name", aber Name nicht in der Kontaktliste enthalten ist, werden Kontakte, die die Anzeigenamen Name1 oder NAME aufweisen, nicht eingeschlossen. Dieses Attribut ist optional.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
FindItem	Definiert eine Anforderung zum Suchen von Elementen in einem Postfach. Für dieses Element wird folgender XPath-Ausdruck verwendet: `/FindItem`

Hinweise

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der MicrosoftExchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.

Beispiel

Im folgenden Beispiel einer Anforderung wird veranschaulicht, wie die ersten drei Kontakte gesucht werden, beginnend mit dem Kontakt, der den Anzeigenamen Kelly Rollin hat.

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

Informationen zu Elementen

Element	Beispiel
Namespace	http://schemas.microsoft.com/exchange/services/2006/messages
Name des Schemas	Nachrichtenschema
Überprüfungsdatei	Messages.xsd
Leer kann sein	False

Freigeben über