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

查询选项更改时触发。

适用于

另请参阅