IStorageFolderQueryOperations.GetFoldersAsync 方法

定义

命名空间:

Windows.Storage.Search

重载

GetFoldersAsync(CommonFolderQuery)	根据指定的文件夹查询检索文件夹和文件组的列表。 这会返回某个时间点的文件夹或文件组快照，并且不允许通过事件跟踪更改。
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)	基于文件夹查询异步检索此文件夹中的一系列文件夹。 这会返回某个时间点的文件夹或文件组快照，并且不允许通过事件跟踪更改。

GetFoldersAsync(CommonFolderQuery)

根据指定的文件夹查询检索文件夹和文件组的列表。 这会返回某个时间点的文件夹或文件组快照，并且不允许通过事件跟踪更改。

public:
 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query);

/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query);

[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query);

function getFoldersAsync(query)

Public Function GetFoldersAsync (query As CommonFolderQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

参数

query

CommonFolderQuery

要执行的文件夹查询的类型。

返回

IAsyncOperation<IVectorView<StorageFolder>>

IAsyncOperation<IReadOnlyList<StorageFolder>>

此方法成功完成后，它将返回一个列表 (类型 IVectorView) 由 StorageFolder 对象表示的文件组的文件夹。

属性

OverloadAttribute RemoteAsyncAttribute

另请参阅

• IStorageFolderQueryOperations
• IVectorView<T>
• StorageFolder

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

基于文件夹查询异步检索此文件夹中的一系列文件夹。 这会返回某个时间点的文件夹或文件组快照，并且不允许通过事件跟踪更改。

public:
 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve);

/// [Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);

[Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query, uint startIndex, uint maxItemsToRetrieve);

function getFoldersAsync(query, startIndex, maxItemsToRetrieve)

Public Function GetFoldersAsync (query As CommonFolderQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

参数

query

CommonFolderQuery

要执行的文件夹查询的类型。

startIndex

UInt32

unsigned int

uint32_t

范围中第一个文件夹或文件组的从零开始的索引。 此参数的默认值为 0。

maxItemsToRetrieve

UInt32

unsigned int

uint32_t

要检索的文件夹或文件组的最大数目。 使用 -1 检索所有文件夹或文件组。

返回

IAsyncOperation<IVectorView<StorageFolder>>

IAsyncOperation<IReadOnlyList<StorageFolder>>

此方法成功完成后，它将返回一个列表 (类型 IVectorView) 由 StorageFolder 对象表示的文件组的文件夹。

属性

OverloadAttribute RemoteAsyncAttribute

注解

使用此重载通过显示查询结果的虚拟视图（仅包含必要的文件夹子集）来检索提高系统性能。

另请参阅

• IStorageFolderQueryOperations
• GetFoldersAsync(CommonFolderQuery)
• IVectorView<T>
• StorageFolder