StorageItemQueryResult クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クエリ対象のフォルダー ( StorageFolder によって表される) 内のファイルとフォルダー (またはファイル グループ) を含むすべてのアイテムを一覧表示するクエリの結果へのアクセスを提供します。 storageItemQueryResult を使用して、その StorageFolder 内のファイルとフォルダーを列挙できます。
public ref class StorageItemQueryResult sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemQueryResult final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemQueryResultPublic NotInheritable Class StorageItemQueryResult- 継承
- 属性
- 実装
Windows の要件
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
注意
では属性付け marshalling_behavior(agile)されませんが、このクラスはアジャイルとして扱うことができます。 詳細については、「 スレッドとマーシャリング (C++/CX)」を参照してください。
storageItemQueryResult オブジェクトを取得するには、 StorageFolder オブジェクトまたは FolderInformation オブジェクトから次のメソッドを呼び出します。
- StorageFolder.CreateItemQuery メソッド
- StorageFolder.CreateItemQueryWithOptions メソッド
- FolderInformation.CreateItemQuery メソッド
- FolderInformation.CreateItemQueryWithOptions メソッド 関連するコード例については、「 storageFileQueryResult、 storageFolderQueryResult、 Folder 列挙サンプル、および ファイル検索サンプル」を参照してください。
プロパティ
| Folder |
StorageItemQueryResult オブジェクトの作成に最初に使用されたフォルダーを取得します。 このフォルダーは、クエリのスコープを表します。 |
メソッド
| ApplyNewQueryOptions(QueryOptions) |
新しい QueryOptions に基づいてクエリ結果を変更します。 |
| FindStartIndexAsync(Object) |
指定したプロパティ値に最も近いクエリ結果から項目のインデックスを取得します。 一致するプロパティは、QueryOptions.SortOrder リストの最初の SortEntry によって決定されます。 |
| GetCurrentQueryOptions() |
クエリ結果の決定に使用されるクエリ オプションを取得します。 |
| GetItemCountAsync() |
クエリ結果のセット内の項目数を取得します。 |
| GetItemsAsync() |
クエリ結果セット内のすべての項目 (ファイルとフォルダー) の一覧を取得します。 |
| GetItemsAsync(UInt32, UInt32) |
指定した範囲内のアイテム (ファイルとフォルダー) の一覧を取得します。 |
イベント
| ContentsChanged |
クエリ対象のフォルダーにアイテムが追加、削除、または変更されると発生します。 このイベントは 、GetItemsAsync が少なくとも 1 回呼び出された後にのみ発生します。 |
| OptionsChanged |
クエリ オプションが変更されたときに発生します。 |