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 열거형에서 <DefaultQuery> 이외의 값을 지정했습니다.

설명

쿼리 결과 개체를 가져오는 방법에 대한 자세한 내용과 예제는 CreateFileQueryWithOptions를 참조하세요.