StorageFolder.CreateItemQueryWithOptions(QueryOptions) 方法

定义

命名空间:

Windows.Storage

获取一个查询结果对象，该对象包含当前文件夹中的文件和子文件夹（可选）当前文件夹的子文件夹中的文件和子文件夹。 结果基于指定的 QueryOptions。

public:
 virtual StorageItemQueryResult ^ CreateItemQueryWithOptions(QueryOptions ^ queryOptions) = CreateItemQueryWithOptions;

StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions const& queryOptions);

public StorageItemQueryResult CreateItemQueryWithOptions(QueryOptions queryOptions);

function createItemQueryWithOptions(queryOptions)

Public Function CreateItemQueryWithOptions (queryOptions As QueryOptions) As StorageItemQueryResult

参数

queryOptions

QueryOptions

应用于查询的条件。

返回

StorageItemQueryResult

查询结果对象。 调用查询结果的 GetItemsAsync 方法，获取当前文件夹中的文件和子文件夹（可选）中的文件和子文件夹，根据指定的 QueryOptions 进行筛选和排序。 此方法返回 IReadOnlyList<IStorageItem> 类型的列表。 每个文件或文件夹都由 IStorageItem 类型的项表示。

若要处理返回的项目，请调用 IStorageItem 接口的 IsOfType 方法，以确定每个项是文件还是文件夹。 然后将项强制转换为 StorageFolder 或 StorageFile。

实现

CreateItemQueryWithOptions(QueryOptions)

例外

UnauthorizedAccessException

您无权访问当前文件夹的内容。

ArgumentException

您为<不是库文件夹的文件夹指定了 xref：Windows.Storage.Search.CommonFileQuery？text=CommonFileQuery> 或 <xref：Windows.Storage.Search.CommonFolderQuery？text=CommonFolderQuery 枚举以外的 DefaultQuery> 值。

注解

有关获取查询结果对象的详细信息和示例，请参阅 CreateFileQueryWithOptions。