StorageFolder.CreateFolderQuery 메서드

정의

네임스페이스:

Windows.Storage

오버로드

CreateFolderQuery()	현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다.
CreateFolderQuery(CommonFolderQuery)	현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값이면 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록을 가져옵니다. 파일은 CommonFolderQuery 열거형의 지정된 값에 따라 폴더로 그룹화됩니다.

CreateFolderQuery()

현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery() = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
StorageFolderQueryResult CreateFolderQuery();

[Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
public StorageFolderQueryResult CreateFolderQuery();

function createFolderQuery()

Public Function CreateFolderQuery () As StorageFolderQueryResult

반환

StorageFolderQueryResult

쿼리 결과 개체입니다. 쿼리 결과의 GetFoldersAsync 메서드를 호출하여 현재 폴더의 하위 폴더를 가져옵니다. 이 메서드는 IReadOnlyList<StorageFolder 형식의 목록을 반환합니다>. 각 파일 또는 폴더는 StorageFolder 형식의 항목으로 표시됩니다.

구현

CreateFolderQuery()

특성

OverloadAttribute

예외

UnauthorizedAccessException

현재 폴더의 내용에 액세스할 수 있는 권한이 없습니다.

예제

다음 예제에서는 GetFoldersAsync(CommonFolderQuery) 오버로드된 메서드를 호출하여 월별로 폴더로 그룹화된 사용자의 Pictures 폴더에 있는 하위 폴더의 콘텐츠를 가져오는 방법을 보여 줍니다. (현재 폴더의 루트에 있는 파일은 포함되지 않습니다.)

다음 예제를 실행하기 전에 앱 매니페스트 파일에서 사진 라이브러리 기능을 사용하도록 설정합니다.

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to the Output window.

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;

// Get the files in the subfolders of the
// user's Pictures folder, grouped by month.
StorageFolderQueryResult groupedItems =
    picturesFolder.CreateFolderQuery(CommonFolderQuery.GroupByMonth);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in await groupedItems.GetFoldersAsync())
{
    Debug.WriteLine(folder.Name);

// To iterate over the files in each folder,
// uncomment the following lines.
// foreach(StorageFile file in await folder.GetFilesAsync())
//    Debug.WriteLine(" " + file.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the users's Pictures folder.
    // Enable the Pictures Library capability in the app manifest file.
    Windows::Storage::StorageFolder picturesFolder{ Windows::Storage::KnownFolders::PicturesLibrary() };

    // Get the files in the user's Pictures folder, and group them by month.
    Windows::Storage::Search::StorageFolderQueryResult results{ picturesFolder.CreateFolderQuery(Windows::Storage::Search::CommonFolderQuery::GroupByMonth) };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
        co_await results.GetFoldersAsync() };

    // Iterate over the results, and print the list of file groups to the Visual Studio output window.
    for (StorageFolder const& itemInFolder : itemsInFolder)
    {
        std::wstring output{ itemInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

// Get user's pictures folder
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder and group them by month
StorageFolderQueryResult^ itemsInFolder = picturesFolder->CreateFolderQuery(CommonFolderQuery::GroupByMonth);

create_task(itemsInFolder->GetFoldersAsync()).then([=](IVectorView<StorageFolder^>^ itemsInFolder) {
 //Iterate over the results and print the list of file groups
 // to the visual studio output window
 for (auto it = itemsInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFolder^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

설명

이 쿼리는 현재 폴더의 하위 폴더만 반환하는 단순 쿼리입니다. 단순 쿼리 및 심층 쿼리를 식별하는 메서드 목록은 GetFoldersAsync 메서드의 비고를 참조하세요.

추가 쿼리 옵션을 지정하려면 CreateFolderQueryWithOptions 메서드를 호출합니다 .

파일 또는 폴더인 항목을 얻으려면 CreateItemQuery 메서드를 호출합니다.

추가 정보

• CreateFolderQuery(CommonFolderQuery)

CreateFolderQuery(CommonFolderQuery)

현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값이면 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록을 가져옵니다. 파일은 CommonFolderQuery 열거형의 지정된 값에 따라 폴더로 그룹화됩니다.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery(CommonFolderQuery query) = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
public StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery query);

function createFolderQuery(query)

Public Function CreateFolderQuery (query As CommonFolderQuery) As StorageFolderQueryResult

매개 변수

query

CommonFolderQuery

파일을 폴더로 그룹화하는 방법을 지정하고 쿼리가 단순하거나 깊은지 여부를 결정하는 열거형 값 중 하나입니다.

반환

StorageFolderQueryResult

쿼리 결과 개체입니다. 쿼리 결과의 GetFoldersAsync 메서드를 호출하여 현재 폴더의 하위 폴더를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값인 경우 쿼리 결과 개체에는 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록이 포함됩니다. (현재 폴더의 파일은 포함되지 않습니다.) 파일은 쿼리에서 지정한 대로 그룹화됩니다. 목록은 IReadOnlyList<StorageFolder 형식입니다>. 목록의 각 폴더는 StorageFolder 개체로 표시됩니다.

구현

CreateFolderQuery(CommonFolderQuery)

특성

OverloadAttribute

예외

UnauthorizedAccessException

현재 폴더의 내용에 액세스할 수 있는 권한이 없습니다.

ArgumentException

라이브러리 폴더가 아닌 폴더에 대해 xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery 열거형에서 <DefaultQuery> 이외의 값을 지정했습니다. 쿼리 값을 확인 합니다.

설명

CommonFolderQuery는 특정 파일 특성(예: 아티스트 또는 앨범)에 따라 하위 폴더의 콘텐츠를 빠르고 쉽게 폴더로 그룹화합니다. DefaultQuery 옵션 지정에 대한 자세한 내용은 CreateFileQuery 메서드 페이지의 설명을 참조하세요.

추가 정보

• CreateFolderQuery()