StorageFolderQueryResult 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供对查询结果的访问,该查询列出要查询的文件夹 (或文件组) , (由 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
- 继承
- 属性
- 实现
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 对象:
- StorageFolder.CreateFolderQuery 方法
- StorageFolder.CreateFolderQueryWithOptions 方法
- FolderInformation.CreateFolderQuery 方法
- FolderInformation.CreateFolderQueryWithOptions 方法
有关演示如何使用 storageFolderQueryResult 对象的更多代码示例,请参阅 Folder 枚举示例。
若要获取 StorageFolderQueryResult 对象以枚举某个位置中的文件夹或文件组,必须获取表示该位置的 storageFolder ,然后创建文件夹查询。
属性
Folder |
获取最初用于创建 StorageFolderQueryResult 对象的文件夹。 此文件夹表示查询的范围。 |
方法
ApplyNewQueryOptions(QueryOptions) |
根据新的 QueryOptions 修改查询结果。 |
FindStartIndexAsync(Object) |
从与指定属性值最匹配的查询结果中检索文件夹的索引。 匹配的属性由 QueryOptions.SortOrder 列表的第一个 SortEntry 确定。 |
GetCurrentQueryOptions() |
检索用于确定查询结果的查询选项。 |
GetFoldersAsync() |
检索结果集中) 的所有文件夹 (或文件组的列表。 |
GetFoldersAsync(UInt32, UInt32) |
检索指定范围内) 的文件夹 (或文件组。 |
GetItemCountAsync() |
检索查询结果集中) (或文件组的文件夹数。 |
事件
ContentsChanged |
在要查询的文件夹中添加、删除或修改文件时触发。 仅当至少调用一次 GetFilesAsync 后,才会触发此事件。 |
OptionsChanged |
查询选项更改时触发。 |