共用方式為

StorageFolderQueryResult 類別

  • 參考

定義

命名空間:
Windows.Storage.Search
編輯

提供查詢結果的存取權，該查詢會列出所查詢資料夾中 (或檔案群組) (，該資料夾是由 StorageFolder) 所代表。 您可以使用 StorageFolderQueryResult 來列舉該資料夾中的資料夾或檔案群組。

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
繼承
Object Platform::Object IInspectable StorageFolderQueryResult
屬性
ContractVersionAttribute
實作
IStorageQueryResultBase

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範如何從 StorageFolderQueryResult 物件取得清單資料夾 (或檔案群組) 。

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

queryResult變數會取得 StorageFolderQueryResult，用來擷取符合查詢準則的檔案群組 (或) 資料夾。

注意

您需要圖片庫功能，才能使用 KnownFolders.PicturesLibrary 存取媒體櫃。 若要深入瞭解功能和檔案存取，請參閱 檔案訪問許可權。

備註

注意

雖然它不是使用 marshalling_behavior(agile)屬性，但這個類別可以視為敏捷式。 如需詳細資訊，請參閱 線程和封送處理 (C++/CX) 。

您可以從 StorageFolder 或 FolderInformation 物件呼叫下列方法，以取得 StorageFolderQueryResult 物件：

如需示範如何使用 storageFolderQueryResult 物件的更多程式碼範例，請參閱 Folder 列舉範例。

若要取得 StorageFolderQueryResult 物件來列舉位置中的資料夾或檔案群組，您必須取得代表位置的 storageFolder ，然後建立資料夾查詢。

屬性

Folder

取得原本用來建立 StorageFolderQueryResult 對象的資料夾。 此資料夾代表查詢的範圍。

方法

ApplyNewQueryOptions(QueryOptions)

根據新的 QueryOptions 修改查詢結果。
FindStartIndexAsync(Object)

從最符合指定屬性值的查詢結果擷取資料夾的索引。 相符的屬性是由 QueryOptions.SortOrder 清單的第一個 SortEntry 所決定。
GetCurrentQueryOptions()

擷取用來判斷查詢結果的查詢選項。
GetFoldersAsync()

擷取結果集中所有資料夾 (或檔案群組的清單) 。
GetFoldersAsync(UInt32, UInt32)

擷取指定範圍內) 資料夾 (或檔案群組。
GetItemCountAsync()

擷取查詢結果集中 (或檔案群組) 的資料夾數目。

事件

ContentsChanged

在查詢的資料夾中新增、刪除或修改檔案時引發。 只有在 呼叫 GetFilesAsync 至少一次之後，才會引發此事件。
OptionsChanged

查詢選項變更時引發。

適用於

另請參閱