FractionalPageItemView
Das FractionalPageItemView-Element beschreibt, wo die seitenseitige Ansicht beginnt und wie viele Elemente in einer FindItem-Anforderung maximal zurückgegeben werden.
<FractionalPageItemView MaxEntriesReturned="" Numerator="" Denominator=""/>
FractionalPageViewType
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
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 ab dem 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. |
Keine.
Element | Beschreibung |
---|---|
FindItem |
Definiert eine Anforderung zum Suchen von Elementen in einem Postfach. Für dieses Element wird folgender XPath-Ausdruck verwendet: /FindItem |
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.
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 beispielsweise neun Elemente enthält, gibt die ausgelagerte Ansicht bis zu 12 Elemente zurück, beginnend mit 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.
Element | Beispiel |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
Name des Schemas |
Nachrichtenschema |
Überprüfungsdatei |
Messages.xsd |
Leer kann sein |
False |