FractionalPageItemView

Das FractionalPageItemView-Element beschreibt, wo die seitenseitige Ansicht beginnt und wie viele Elemente in einer FindItem-Anforderung maximal zurückgegeben werden.

FindItem

FractionalPageItemView

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

FractionalPageViewType

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
MaxEntriesReturned	Gibt die maximale Anzahl von Ergebnissen an, die in der FindItem-Antwort zurückgegeben werden sollen. Dieses Attribut ist optional. Wenn dieses Attribut nicht angegeben ist, gibt der Aufruf alle verfügbaren Elemente zurück.
Zähler	Stellt den Zähler des Bruchoffsets vom Anfang des Resultsets dar. Dieses Attribut ist erforderlich. Der Zähler muss gleich oder kleiner als der Nenner sein. Dieses Attribut muss einen ganzzahligen Wert darstellen, der gleich oder größer als 0 (null) ist. Weitere Informationen finden Sie unter Hinweise weiter unten in diesem Thema.
Nenner	Stellt den Nenner des Bruchoffsets vom Anfang der Gesamtzahl der Elemente im Resultset dar. Dieses Attribut ist erforderlich. Dieses Attribut muss einen ganzzahligen Wert darstellen, der größer als eins ist. Weitere Informationen finden Sie unter Hinweise weiter unten in diesem Thema.

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

HinwBemerkungeneise

Der Seitenansichtsoffset vom Anfang des Satzes gefundener Elemente wird durch einen Bruch beschrieben. Der Bruch, der durch die Attribute Zähler und Nenner definiert wird, beschreibt, wo die Informationsseite beginnt. Wenn der Numerator z. B. gleich 4 und Nenner gleich fünf ist, beginnt die Seite der zurückgegebenen Informationen bei einem Eintrag, der sich vier Fünftel des Wegs in das Resultset befindet.

Wenn der Bruch zu 0 (null) ausgewertet wird, gibt dies den Anfang des Resultsets an. Wenn der Bruch als 1 ausgewertet wird, gibt dies das Ende des Resultsets an.

Hinweis

Der Bruch stellt den Anfangspunkt der Seite dar, nicht die Anzahl der Ergebnisse im Resultset, die zurückgegeben werden.

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

Das folgende Beispiel zeigt eine FindItem-Anforderung . Die Anforderung gibt Elemente aus den Suchergebnissen zurück, die nach dem zweiten Drittel aller Elemente im Resultset beginnen.

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

Wenn das Resultset z. B. neun Elemente enthält, gibt die ausgelagerte Ansicht bis zu 12 Elemente zurück, beginnend bei dem gefundenen Element zwei Drittel des Weges in das Resultset. In diesem Fall beginnt die Seite am siebten Element. Die Seite enthält die siebten, achten und neunten Elemente. Wenn der Zähler auf 0 festgelegt ist, gibt die Seitenansicht alle Elemente im Resultset zurück, solange die Zahl kleiner als das MaxEntriesReturned-Attribut ist.

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

Siehe auch

FindItem-Vorgang

Suchen von Elementen