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 StorageItemQueryResult
Public 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 枚举示例和 文件搜索示例。
属性
Folder |
获取最初用于创建 StorageItemQueryResult 对象的文件夹。 此文件夹表示查询的范围。 |
方法
ApplyNewQueryOptions(QueryOptions) |
根据新的 QueryOption 修改查询结果。 |
FindStartIndexAsync(Object) |
从与指定属性值最匹配的查询结果中检索项的索引。 匹配的属性由 QueryOptions.SortOrder 列表的第一个 SortEntry 确定。 |
GetCurrentQueryOptions() |
检索用于确定查询结果的查询选项。 |
GetItemCountAsync() |
检索查询结果集中的项数。 |
GetItemsAsync() |
检索查询结果集中) 文件和文件夹 (所有项的列表。 |
GetItemsAsync(UInt32, UInt32) |
检索指定范围内) 文件和文件夹 (项列表。 |
事件
ContentsChanged |
在查询的文件夹中将项目添加到、从中删除或修改项时触发。 仅在至少调用一次 GetItemsAsync 后,才会触发此事件。 |
OptionsChanged |
查询选项更改时触发。 |