共用方式為


StorageFolder.CreateItemQueryWithOptions(QueryOptions) 方法

定義

取得查詢結果物件,其中包含目前資料夾中的檔案和子資料夾,以及選擇性地包含在目前資料夾的子資料夾中。 結果是以指定的 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

套用至查詢的準則。

傳回

查詢結果物件。 呼叫查詢結果的 GetItemsAsync 方法,以取得目前資料夾中的檔案和子資料夾,並選擇性地在目前資料夾的子資料夾中,根據指定的 QueryOptions篩選和排序。 這個方法會傳回IReadOnlyList<IStorageItem> 類型的清單。 每個檔案或資料夾都是以 IStorageItem類型的專案來表示。

若要使用傳回的專案,請呼叫IStorageItem介面的IsOfType方法,以判斷每個專案都是檔案或資料夾。 然後將專案轉換成 StorageFolderStorageFile

實作

例外狀況

您沒有許可權存取目前資料夾的內容。

指定了< xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery > 或 < xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery?text=CommonFolderQuery > 列舉以外的值。

備註

如需取得查詢結果物件的詳細資訊和範例,請參閱 CreateFileQueryWithOptions

適用於