FractionalPageItemViewFractionalPageItemView

L’élément FractionalPageItemView décrit l’emplacement où l’affichage paginé démarre et le nombre maximal d’éléments renvoyés dans une demande FindItem .The FractionalPageItemView element describes where the paged view starts and the maximum number of items returned in a FindItem request.

FindItemFindItem

FractionalPageItemViewFractionalPageItemView

<FractionalPageItemView MaxEntriesReturned="" Numerator="" Denominator=""/>

FractionalPageViewTypeFractionalPageViewType

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
Identifie le nombre maximal de résultats à renvoyer dans la réponse FindItem .Identifies the maximum number of results to return in the FindItem response. Cet attribut est facultatif.This attribute is optional. Si cet attribut n’est pas spécifié, l’appel renverra tous les éléments disponibles.If this attribute is not specified, the call will return all available items.
MonnaieNumerator
Représente le numérateur du décalage fractionnaire à partir du début du jeu de résultats.Represents the numerator of the fractional offset from the start of the result set. Cet attribut est obligatoire.This attribute is required. Le numérateur doit être inférieur ou égal au dénominateur.The numerator must be equal to or less than the denominator. Cet attribut doit représenter une valeur intégrale égale ou supérieure à zéro.This attribute must represent an integral value that is equal to or greater than zero.
Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.For more information, see Remarks later in this topic.
PetitDenominator
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.Represents the denominator of the fractional offset from the start of the total number of items in the result set. Cet attribut est obligatoire.This attribute is required. Cet attribut doit représenter une valeur intégrale supérieure à 1.This attribute must represent an integral value that is greater than one.
Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.For more information, see Remarks later in this topic.

É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 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 start of the set of found items is described by a fraction. La fraction, définie par les attributs numérateur et dénominateur , décrit l’emplacement de début de la page d’informations.The fraction, which is defined by the Numerator and Denominator attributes, describes where the page of information starts. Par exemple, si le numérateur est égal à quatre et que le dénominateur est égal à cinq, la page des informations retournées commence à une entrée située quatre cinquièmes du contenu du jeu de résultats.For example, if Numerator equals four and Denominator equals five, the page of returned information starts at an entry located four-fifths of the way in to the result set.

Si la fraction est égale à zéro, cela indique le début du jeu de résultats.If the fraction evaluates to zero, that indicates the start of the results set. Si la fraction est égale à 1, cela indique la fin du jeu de résultats.If the fraction evaluates to one, that indicates the end of the result set.

Notes

La fraction représente le point de départ de la page, pas le nombre de résultats dans le jeu de résultats.The fraction represents the start point of page, not how many results in the result set will be returned.

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 suivant montre une requête FindItem .The following example shows a FindItem request. La requête renvoie les é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.The request returns items from the search results that start after the second third of all the items in the result set.

<?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="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 renverra jusqu’à 12 éléments, à partir de l’élément a trouvé deux-tiers de la méthode dans le jeu de résultats.For example, if the result set contains nine items, the paged view will return up to 12 items, starting at the item found two-thirds of the way in to the result set. Dans ce cas, la page commence au septième élément.In this case, the page starts at the seventh item. La page contiendra les septième, huitième et neuvième éléments.The page will contain the seventh, eighth, and ninth items. Si le numérateur est défini sur zéro, l’affichage de la page renverra tous les éléments dans le jeu de résultats tant que le nombre est inférieur à l’attribut MaxEntriesReturned .If the numerator is set to zero, the page view will return all the items in the result set as long as the number is less than the MaxEntriesReturned attribute.

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

Opération FindItemFindItem operation

Recherche d’élémentsFinding Items