StorageItemQueryResult 類別

定義

命名空間:

Windows.Storage.Search

提供查詢結果的存取權，其中列出所有專案，包括要查詢之資料夾中的檔案和資料夾 (或檔案群組) ， (由 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 StorageItemQueryResult

Public NotInheritable Class StorageItemQueryResult

繼承

Object Platform::Object IInspectable StorageItemQueryResult

屬性

ContractVersionAttribute

實作

IStorageQueryResultBase

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	查詢選項變更時引發。

另請參閱

• GetItemsAsync()
• CreateItemQuery()
• CreateItemQueryWithOptions(QueryOptions)
• CreateItemQuery()
• CreateItemQueryWithOptions(QueryOptions)