FindItemFindItem

L’élément FindItem définit une demande pour rechercher des éléments dans une boîte aux lettres.The FindItem element defines a request to find items in a mailbox.

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

FindItemTypeFindItemType

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
TraverséeTraversal
Détermine si la recherche trouve des éléments dans des dossiers ou dans les bennes de dossiers.Defines whether the search finds items in folders or the folders' dumpsters. Cet attribut est obligatoire.This attribute is required.

Valeurs d’attribut transversalTraversal attribute values

ValeurValue DescriptionDescription
PartielleShallow
Renvoie uniquement les identités des éléments du dossier.Returns only the identities of items in the folder.
SoftDeletedSoftDeleted
Renvoie uniquement les identités des éléments situés dans la benne d’un dossier.Returns only the identities of items that are in a folder's dumpster. Notez qu’une traversée supprimée de manière récupérable combinée à une restriction de recherche entraîne zéro élément retourné même s’il existe des éléments qui correspondent aux critères de recherche.Note that a soft-deleted traversal combined with a search restriction will result in zero items returned even if there are items that match the search criteria.
Associé àAssociated
Renvoie uniquement les identités des éléments associés dans le dossier.Returns only the identities of associated items in the folder.

Éléments enfantsChild elements

ÉlémentElement DescriptionDescription
ItemShapeItemShape
Identifie les propriétés d’élément et le contenu à inclure dans une réponse d' opération FindItem .Identifies the item properties and content to include in a FindItem operation response.
IndexedPageItemViewIndexedPageItemView
Décrit comment les informations d’élément paginé sont renvoyées pour une demande FindItem .Describes how paged item information is returned for a FindItem request. Cet élément est facultatif.This element is optional.
FractionalPageItemViewFractionalPageItemView
Décrit l’emplacement où l’affichage paginé démarre et le nombre maximal d’éléments renvoyés dans une requête FindItem .Describes where the paged view starts and the maximum number of items returned in a FindItem request. Le décalage de l’affichage paginé à partir du début de l’ensemble des éléments trouvés est décrit par une fraction.The paged view offset from the beginning of the set of found items is described by a fraction. Cet élément est facultatif.This element is optional.
CalendarViewCalendarView
Fournit des limites de durée de temps pour définir une recherche pour les éléments de calendrier.Provides time span limits to define a search for calendar items. Cet élément est facultatif.This element is optional.
ContactsViewContactsView
Définit une recherche pour les éléments de contact en fonction des noms d’affichage alphabétiques.Defines a search for contact items based on alphabetical display names. Cet élément est facultatif.This element is optional.
GroupByGroupBy
Spécifie des groupes arbitraires pour les requêtes FindItem .Specifies arbitrary groupings for FindItem queries. Cet élément est facultatif.This element is optional.
DistinguishedGroupByDistinguishedGroupBy
Fournit des regroupements standard pour les requêtes FindItem .Provides standard groupings for FindItem queries. Cet élément est facultatif.This element is optional.
RestrictionRestriction
Définit la restriction ou la requête utilisée pour filtrer des éléments ou des dossiers FindItemdans / les opérations FindItemFindFolder et Search Folder.Defines the restriction or query that is used to filter items or folders in FindItem/ FindFolder and search folder operations. Cet élément est facultatif.This element is optional.
SortOrderSortOrder
Définit le mode de tri des éléments dans une requête FindItem.Defines how items are sorted in a FindItem request. Cet élément est facultatif.This element is optional.
ParentFolderIdsParentFolderIds
Identifie les dossiers dans lesquels rechercher les opérations FindItem et FindFolder.Identifies folders to search for the FindItem and FindFolder operations.
QueryString (QueryStringType)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).Contains a mailbox query string based on Advanced Query Syntax (AQS).

Éléments parentsParent elements

Aucun.None.

RemarquesRemarks

Un seul des éléments IndexedPageItemView, FractionalPageItemView, CalendarViewou ContactsView peut être inclus dans une demande FindItem .Only one of the IndexedPageItemView, FractionalPageItemView, CalendarView, or ContactsView elements can be included in a FindItem request. Un seul des éléments GroupBy ou DistinguishedGroupBy peut être inclus dans une demande FindItem .Only one of the GroupBy or DistinguishedGroupBy elements can be included in a FindItem request.

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.

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