FractionalPageItemView
L’élément FractionalPageItemView décrit l’emplacement de début de l’affichage paginé et le nombre maximal d’éléments retournés dans une requête FindItem.
<FractionalPageItemView MaxEntriesReturned="" Numerator="" Denominator=""/>
FractionalPageViewType
Attributs et éléments
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
| Attribut | Description |
|---|---|
| MaxEntriesReturned |
Identifie le nombre maximal de résultats à retourner dans la réponse FindItem . Cet attribut est facultatif. Si cet attribut n’est pas spécifié, l’appel retourne tous les éléments disponibles. |
| Numérateur |
Représente le numérateur du décalage fractionnaire à partir du début du jeu de résultats. Cet attribut est obligatoire. Le numérateur doit être égal ou inférieur au dénominateur. Cet attribut doit représenter une valeur intégrale égale ou supérieure à zéro. Pour plus d’informations, consultez remarques plus loin dans cette rubrique. |
| Dénominateur |
Représente le dénominateur du décalage fractionnaire à partir du début du nombre total d’éléments dans le jeu de résultats. Cet attribut est obligatoire. Cet attribut doit représenter une valeur intégrale supérieure à une. Pour plus d’informations, consultez remarques plus loin dans cette rubrique. |
É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 décalage d’affichage paginé par rapport au début de l’ensemble d’éléments trouvés est décrit par une fraction. La fraction, qui est définie par les attributs Numérateur et Dénominateur , décrit l’emplacement de début de la page d’informations. Par exemple, si numérateur est égal à quatre et que dénominateur est égal à cinq, la page d’informations retournées commence à une entrée située aux quatre cinquièmes du chemin dans le jeu de résultats.
Si la fraction est évaluée à zéro, cela indique le début du jeu de résultats. Si la fraction est évaluée à un, cela indique la fin du jeu de résultats.
Remarque
La fraction représente le point de départ de la page, et non le nombre de résultats retournés dans le jeu de résultats.
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 montre une requête FindItem . La requête retourne des éléments à partir des résultats de la recherche qui commencent après le deuxième tiers de tous les éléments du jeu de résultats.
<?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="item:Subject"/>
</t:AdditionalProperties>
</ItemShape>
<FractionalPageItemView MaxEntriesReturned="12" Numerator="2" Denominator="3"/>
<GroupBy Order="Descending">
<t:FieldURI FieldURI="item:Importance"/>
<t:AggregateOn Aggregate="Maximum">
<t:FieldURI FieldURI="item:Subject"/>
</t:AggregateOn>
</GroupBy>
<ParentFolderIds>
<t:DistinguishedFolderId Id="inbox"/>
</ParentFolderIds>
</FindItem>
</soap:Body>
</soap:Envelope>
Par exemple, si le jeu de résultats contient neuf éléments, la vue paginée retourne jusqu’à 12 éléments, en commençant par les deux tiers de l’élément trouvé dans le jeu de résultats. Dans ce cas, la page commence au septième élément. La page contient les septième, huitième et neuvième éléments. Si le numérateur est défini sur zéro, l’affichage page renvoie tous les éléments du jeu de résultats tant que le nombre est inférieur à l’attribut MaxEntriesReturned .
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 |