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) 。
您可以從 StorageFolder 或 FolderInformation 物件呼叫下列方法，以取得 storageItemQueryResult 物件：
- StorageFolder.CreateItemQuery 方法
- StorageFolder.CreateItemQueryWithOptions 方法
- FolderInformation.CreateItemQuery 方法
- FolderInformation.CreateItemQueryWithOptions 方法 如需相關的程式碼範例，請參閱 storageFileQueryResult、storageFolderQueryResult、資料夾列舉範例，以及檔案搜尋範例。
屬性
| Folder |
取得原本用來建立 StorageItemQueryResult 對象的資料夾。 此資料夾代表查詢的範圍。 |
方法
| ApplyNewQueryOptions(QueryOptions) |
根據新的 QueryOptions 修改查詢結果。 |
| FindStartIndexAsync(Object) |
從最符合指定屬性值的查詢結果擷取專案的索引。 相符的屬性是由 QueryOptions.SortOrder 清單的第一個 SortEntry 所決定。 |
| GetCurrentQueryOptions() |
擷取用來判斷查詢結果的查詢選項。 |
| GetItemCountAsync() |
擷取查詢結果集中的項目數目。 |
| GetItemsAsync() |
擷取查詢結果集中所有專案 (檔案和資料夾的清單) 。 |
| GetItemsAsync(UInt32, UInt32) |
擷取指定範圍內) (檔案和資料夾的項目清單。 |
事件
| ContentsChanged |
在查詢的資料夾中新增、刪除或修改項目時引發。 只有在 至少呼叫 GetItemsAsync 一次之後，才會引發此事件。 |
| OptionsChanged |
查詢選項變更時引發。 |