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？text=CommonFolderQuery > 列舉以外的值。

備註

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