StorageFolder.AreQueryOptionsSupported(QueryOptions) 方法

定义

命名空间:

Windows.Storage

指示当前文件夹是否支持指定的 QueryOptions。

public:
 virtual bool AreQueryOptionsSupported(QueryOptions ^ queryOptions) = AreQueryOptionsSupported;

bool AreQueryOptionsSupported(QueryOptions const& queryOptions);

public bool AreQueryOptionsSupported(QueryOptions queryOptions);

function areQueryOptionsSupported(queryOptions)

Public Function AreQueryOptionsSupported (queryOptions As QueryOptions) As Boolean

参数

queryOptions

QueryOptions

要检查的 QueryOptions。

返回

Boolean

bool

如此 如果文件夹或文件组支持指定的 QueryOptions;否则为 false。

实现

AreQueryOptionsSupported(QueryOptions)

注解

QueryOptions 允许枚举文件夹及其子文件夹中的文件，方法是指定条件，然后可用于创建该文件夹和子文件夹中文件的查询结果对象。 CommonFileQuery 和 CommonFolderQuery 枚举表示用于筛选和枚举文件和文件夹的一些最常见条件。

使用 AreQueryOptionsSupported 方法验证要指定的 QueryOptions 是否可用于当前文件夹。 还可以通过分别调用 IsCommonFileQuerySupported 或 IsCommonFolderQuerySupported 来检查特定的 CommonFileQuery 或 CommonFolderQuery 值是否可用。

可用的特定选项取决于要枚举的文件或文件夹所在的位置。 对于位于库或家庭组中的文件夹和文件，可以使用 QueryOptions 的任意组合。

库或家庭组外部的文件夹和文件仅支持一部分选项。

• 对于仅枚举顶级文件或文件夹 (也称为浅查询) 的查询，请使用以下三种方法之一创建 QueryOptions 对象：

  • 调用默认 的 QueryOptions () 构造函数。
  • ) 构造函数 调用 QueryOptions (CommonFolderQuery 并指定 CommonFolderQuery。DefaultQuery。
  • 调用 QueryOptions (CommonFileQuery、IIterable (String) ) 构造函数并指定 CommonFileQuery。DefaultQuery。 使用此构造函数时，仍可以指定要筛选的文件类型。

• 对于枚举当前文件夹及其子文件夹中的所有文件的查询， (也称为深度查询) ，请使用以下两种方式之一创建 QueryOptions 对象：

  • ) 构造函数 调用 QueryOptions (CommonFolderQuery 并指定 CommonFileQuery。OrderByName 或 CommonFileQuery。OrderBySearchRank。
  • 调用 QueryOptions (CommonFileQuery、IIterable (String) ) 构造函数并指定 CommonFileQuery。OrderByName 或 CommonFileQuery。OrderBySearchRank。 使用此构造函数时，仍可以指定要筛选的文件类型。

对于 Windows Server 2012 必须安装索引器组件才能使用某些 QueryOptions、 CommonFileQuery 值和 CommonFolderQuery 值，因为默认情况下未安装索引器组件。