StorageFolder.AreQueryOptionsSupported(QueryOptions) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のフォルダーが指定した 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。
戻り値
bool
フォルダーまたはファイル グループが指定した QueryOptions をサポートしている場合は True。それ以外の場合は false。
実装
注釈
QueryOptions を使用すると、フォルダーとそのサブフォルダー内のファイルを列挙できます。これにより、そのフォルダーとサブフォルダー内のファイルのクエリ結果オブジェクトを作成するために使用できる条件を指定できます。 CommonFileQuery 列挙体と CommonFolderQuery 列挙体は、ファイルとフォルダーのフィルター処理と列挙に使用される最も一般的な条件の一部を表します。
AreQueryOptionsSupported メソッドを使用して、指定する QueryOptions が現在のフォルダーで使用可能であることを確認します。 IsCommonFileQuerySupported または IsCommonFolderQuerySupported を呼び出すことで、特定の CommonFileQuery 値と CommonFolderQuery 値のどちらを使用できるかをチェックすることもできます。
使用できる特定のオプションは、列挙するファイルまたはフォルダーの場所によって異なります。 ライブラリまたはホーム グループ内にあるフォルダーとファイルの場合は、 QueryOptions の任意の組み合わせを使用できます。
ライブラリまたはホーム グループの外部にあるフォルダーとファイルは、オプションのサブセットのみをサポートします。
最上位のファイルまたはフォルダー (シャロー クエリとも呼ばれます) のみを列挙するクエリの場合は、次の 3 つの方法のいずれかで QueryOptions オブジェクトを作成します。
- 既定の QueryOptions() コンストラクターを 呼び出します。
- QueryOptions(CommonFolderQuery) コンストラクターを呼び出し、CommonFolderQuery を指定します。DefaultQuery。
- QueryOptions(CommonFileQuery, IIterable(String)) コンストラクターを呼び出し、CommonFileQuery を指定します。DefaultQuery。 このコンストラクターを使用する場合でも、フィルター処理するファイルの種類を指定できます。
現在のフォルダーとそのサブフォルダー (ディープ クエリとも呼ばれます) 内のすべてのファイルを列挙するクエリの場合は、次の 2 つの方法のいずれかで QueryOptions オブジェクトを作成します。
- QueryOptions(CommonFolderQuery) コンストラクターを呼び出し、CommonFileQuery を指定します。OrderByName または CommonFileQuery。OrderBySearchRank。
- QueryOptions(CommonFileQuery, IIterable(String)) コンストラクターを呼び出し、CommonFileQuery を指定します。OrderByName または CommonFileQuery。OrderBySearchRank。 このコンストラクターを使用する場合でも、フィルター処理するファイルの種類を指定できます。
Windows Server 2012 の場合 インデクサー コンポーネントは既定ではインストールされないため、一部の QueryOptions、 CommonFileQuery 値、 CommonFolderQuery 値を使用するには、インデクサー コンポーネントをインストールする必要があります。