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

bool

如果資料夾或檔案群組支援指定的 QueryOptions，則為 True;否則為 false。

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 值，因為預設不會安裝索引子元件。