Share via

FractionalPageItemView

  • [アーティクル]

FractionalPageItemView 要素は、ページビューが開始される場所と、FindItem 要求で返されるアイテムの最大数について説明します。

FindItem

FractionalPageItemView

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

FractionalPageViewType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
MaxEntriesReturned
FindItem 応答で返される結果の最大数を識別します。 この属性は省略可能です。 この属性が指定されていない場合、呼び出しは使用可能なすべての項目を返します。
分子
結果セットの先頭からの小数部オフセットの分子を表します。 この属性は必須です。 分子は分母以下である必要があります。 この属性は、0 以上の整数値を表す必要があります。
詳細については、このトピックの後半の「備考」を参照してください。
分母
結果セット内の項目の合計数の先頭からの小数オフセットの分母を表します。 この属性は必須です。 この属性は、1 より大きい整数値を表す必要があります。
詳細については、このトピックの後半の「備考」を参照してください。

子要素

なし。

親要素

要素 説明
FindItem
メールボックス内のアイテムを検索する要求を定義します。
この要素への XPath 式を次に示します:
/FindItem

注釈

見つかった項目のセットの先頭からのページ ビュー オフセットは、分数で記述されます。 Numerator 属性と分母属性によって定義される分数は、情報のページの開始位置を示します。 たとえば、 Numerator が 4 に等しく 、分母 が 5 に等しい場合、返される情報のページは、結果セットへの方向の 5 分の 4 にあるエントリから始まります。

分数が 0 と評価された場合、結果セットの開始を示します。 分数が 1 と評価された場合、結果セットの末尾を示します。

注:

小数部はページの開始点を表し、返される結果セットの結果の数は表しません。

この要素を記述するスキーマは、クライアント アクセス サーバーの役割がインストールされている MicrosoftExchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあります。

例

次の例は 、FindItem 要求を示しています。 要求は、結果セット内のすべての項目の 2 番目の 3 分の 1 以降に開始される検索結果から項目を返します。

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

たとえば、結果セットに 9 つの項目が含まれている場合、ページ ビューは最大 12 個の項目を返します。最初は、結果セットへの 3 分の 2 が見つかった項目から始まります。 この場合、ページは 7 番目の項目から始まります。 ページには、7 番目、8 番目、および 9 番目の項目が含まれます。 分子が 0 に設定されている場合、数値が MaxEntriesReturned 属性より小さい限り、ページ ビューは結果セット内のすべての項目を返します。

要素の情報

要素 例
Namespace
 https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名
 メッセージ スキーマ
検証ファイル
 Messages.xsd
空に設定可能
 False

関連項目

FindItem 操作

アイテムの検索