FindItem

FindItem 要素は、メールボックス内のアイテムを検索する要求を定義します。

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/> 
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
   <QueryString/>
</FindItem>

FindItemType

属性と要素

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

属性

属性	説明
トラバーサル	検索でフォルダー内のアイテムを検索するか、フォルダーのダンプスターを検索するかを定義します。 この属性は必須です。

トラバーサル属性値

値	説明
浅い	フォルダー内のアイテムの ID のみを返します。
削除済み (回復可能)	フォルダーのごみ箱内にある項目の ID のみを返します。 論理的に削除されたトラバーサルと検索制限を組み合わせると、検索条件に一致する項目がある場合でも、0 個の項目が返されることに注意してください。
関連	フォルダー内の関連付けられている項目の ID のみを返します。

子要素

Element	説明
ItemShape	FindItem 操作の応答に含める項目のプロパティとコンテンツを識別します。
IndexedPageItemView	FindItem 要求に対してページングされたアイテム情報を返す方法について説明します。 この要素は省略できます。
FractionalPageItemView	ページ ビューの開始場所と 、FindItem 要求で返されるアイテムの最大数について説明します。 見つかった項目のセットの先頭からのページ ビュー オフセットは、分数で記述されます。 この要素は省略できます。
CalendarView	予定表アイテムの検索を定義するための期間制限を提供します。 この要素は省略できます。
ContactsView	アルファベット順の表示名に基づいて連絡先アイテムの検索を定義します。 この要素は省略できます。
GroupBy	FindItem クエリの任意のグループ化を指定します。 この要素は省略できます。
DistinguishedGroupBy	FindItem クエリの標準グループ化を提供します。 この要素は省略できます。
Restriction	FindItem/ FindFolder および検索フォルダー操作でアイテムまたはフォルダーをフィルター処理するために使用される制限またはクエリを定義します。 この要素は省略できます。
SortOrder	FindItem 要求での項目の並べ替え方法を定義します。 この要素は省略できます。
ParentFolderIds	FindItem 操作と FindFolder 操作を検索するフォルダーを識別します。
QueryString (QueryStringType)	高度なクエリ構文 (AQS) に基づくメールボックス クエリ文字列が含まれています。

親要素

なし。

注釈

FindItem 要求には、IndexedPageItemView、FractionalPageItemView、CalendarView、または ContactsView のいずれかの要素のみを含めることができます。 FindItem 要求に含めることができる GroupBy 要素または DistinguishedGroupBy 要素は 1 つだけです。

この要素を記述するスキーマは、Exchange Web サービスをホストする IIS 仮想ディレクトリに置かれています。

要素の情報

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

関連項目

• FindItem 操作
• アイテムの検索