FindItem

Article
03/29/2023

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

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/> 
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

FindItemType

Attributs et éléments

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

Attributs

Attribut	Description
Traversée	Définit si la recherche recherche des éléments dans des dossiers ou dans les dumpsters des dossiers. Cet attribut est obligatoire.

Valeurs d’attribut de traversée

Valeur	Description
Peu profonde	Retourne uniquement les identités des éléments du dossier.
Suppression réversible	Retourne uniquement les identités des éléments qui se trouvent dans la benne à ordures d’un dossier. Notez qu’une traversée supprimée de manière réversible combinée à une restriction de recherche entraîne le renvoi de zéro élément, même s’il existe des éléments qui correspondent aux critères de recherche.
Associés	Retourne uniquement les identités des éléments associés dans le dossier.

Éléments enfants

Élément	Description
ItemShape	Identifie les propriétés et le contenu de l’élément à inclure dans une réponse d’opération FindItem .
IndexedPageItemView	Décrit comment les informations d’élément paginées sont retournées pour une requête FindItem . Cet élément est facultatif.
FractionalPageItemView	Décrit l’emplacement de démarrage de l’affichage paginé et le nombre maximal d’éléments retournés dans une requête FindItem . Le décalage d’affichage paginé par rapport au début de l’ensemble d’éléments trouvés est décrit par une fraction. Cet élément est facultatif.
CalendarView	Fournit des limites d’intervalle de temps pour définir une recherche d’éléments de calendrier. Cet élément est facultatif.
ContactsView	Définit une recherche d’éléments de contact basée sur des noms d’affichage alphabétiques. Cet élément est facultatif.
GroupBy	Spécifie des regroupements arbitraires pour les requêtes FindItem . Cet élément est facultatif.
DistinguishedGroupBy	Fournit des regroupements standard pour les requêtes FindItem . Cet élément est facultatif.
Restriction	Définit la restriction ou la requête utilisée pour filtrer des éléments ou des dossiers dans les opérations FindItem/ FindFolder et de dossier de recherche. Cet élément est facultatif.
SortOrder	Définit la façon dont les éléments sont triés dans une requête FindItem. Cet élément est facultatif.
ParentFolderIds	Identifie les dossiers pour rechercher les opérations FindItem et FindFolder.
QueryString (QueryStringType)	Contient une chaîne de requête de boîte aux lettres basée sur la syntaxe de requête avancée (AQS).

Éléments parents

Aucun.

Remarques

Un seul des éléments IndexedPageItemView, FractionalPageItemView, CalendarView ou ContactsView peut être inclus dans une requête FindItem . Un seul des éléments GroupBy ou DistinguishedGroupBy peut être inclus dans une requête FindItem .

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.

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