정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

CommonFolderQuery Enumeration

쿼리 유형(단순 또는 상세)과 쿼리 결과에서 파일을 폴더로 그룹화하는 데 사용할 정렬 기준을 지정합니다. 상세 쿼리의 쿼리 결과에는 쿼리한 폴더의 모든 하위 폴더에 있는 모든 파일이 포함되며 지정된 메타데이터를 기준으로 결과를 그룹화합니다.

구문


var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery;

특성

[Version(0x06020000)]

멤버

CommonFolderQuery열거형에는 다음과 같은 멤버가 있습니다.

멤버Description
DefaultQuery | defaultQuery0

쿼리된 폴더의 폴더에 대한 얕은 보기이며, Windows 탐색기와 유사한 보기입니다. 이 옵션은 모든 위치에서 유효합니다.

GroupByYear | groupByYear100

각 파일의 System.ItemDate 속성을 기반으로 파일을 연도별 가상 폴더로 그룹화합니다. 각 폴더에는 동일한 연도 동안 System.ItemDate 값이 있는 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByMonth | groupByMonth101

각 파일의 System.ItemDate 속성을 기반으로 파일을 월별 가상 폴더로 그룹화합니다. 각 결과 폴더에는 동일한 월 동안 System.ItemDate 값이 있는 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByArtist | groupByArtist102

각 파일의 System.Music.Artist 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더에는 System.Music.Artist 값이 동일한 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByAlbum | groupByAlbum103

각 파일의 System.Music.AlbumTitle 속성을 기반으로 파일을 연도별 가상 폴더로 그룹화합니다. 각 결과 폴더에는 System.Music.AlbumTitle 값이 동일한 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByAlbumArtist | groupByAlbumArtist104

각 파일의 System.Music.AlbumArtist 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더에는 System.Music.AlbumArtist 값이 동일한 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByComposer | groupByComposer105

각 파일의 System.Music.Composer 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더는 한 명의 작곡가를 나타내며 System.Music.Composer 벡터에 해당 작곡가가 포함된 모든 파일을 포함합니다. 파일이 여러 작성기를 나열할 경우 파일이 둘 이상의 결과 폴더에 나타날 수 있습니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByGenre | groupByGenre106

각 파일의 System.Music.Genre 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더에는 System.Music.Genre 값이 동일한 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByPublishedYear | groupByPublishedYear107

각 파일의 System.Media.Year 속성을 기반으로 파일을 연도별 가상 폴더로 그룹화합니다. 각 결과 폴더에는 동일한 연도 동안 System.Media.Year 값이 있는 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByRating | groupByRating108

각 파일의 System.Rating 속성을 기반으로 파일을 등급(별 1개, 별 2개 등)별로 가상 폴더로 그룹화합니다. 각 결과 폴더에는 System.Rating 값이 동일한 파일만 모두 포함됩니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByTag | groupByTag109

각 파일의 System.Keywords 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더는 하나의 태그를 나타내며 System.Keywords 벡터에 해당 태그가 포함된 모든 파일을 포함합니다. 파일이 System.Keywords 벡터의 여러 태그를 나열할 경우 파일이 둘 이상의 결과 폴더에 나타날 수 있습니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByAuthor | groupByAuthor110

각 파일의 System.Author 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 결과 폴더는 한 명의 작성자를 나타내며 System.Author 벡터에 해당 작성자가 포함된 모든 파일을 포함합니다. 파일이 여러 작성자를 나열할 경우 파일이 둘 이상의 결과 폴더에 나타날 수 있습니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

GroupByType | groupByType111

각 파일의 System.ItemTypeText 속성을 기반으로 형식(Microsoft Word 문서, 텍스트 파일 등)별로 파일을 가상 폴더로 그룹화합니다.

이 옵션은 쿼리 중인 폴더가 라이브러리 또는 HomeGroup 폴더에 있는 경우에만 작동합니다.

설명

System.Author와 같은 다중 값 속성을 기반으로 파일을 가상 폴더로 그룹화할 때 각 그룹은 고유 값을 나타내므로 특정 파일이 두 개 이상의 폴더에 나타날 수 있습니다.

이 열거형을 사용하여 다음 메서드 중 하나를 호출하여 StorageFolderQueryResult를 만들거나 QueryOptions를 생성합니다.

이러한 메서드는 열거형을 사용하여 쿼리의 DateStackOption, FolderDepth, IndexerOptionSortOrder 옵션을 초기화합니다.

StorageFolderQueryResult 개체를 사용하여 결과 폴더의 내용을 열거할 수 있습니다.

예제

이 열거형을 사용하여 다음 예제처럼 storageFolder 위치에 등급을 지정하여 파일을 그룹화하는 방법을 지정합니다.


var picturesLibrary = Windows.Storage.KnownFolders.picturesLibrary;
var storageFolderQueryResults = picturesLibrary.createFolderQuery(Windows.Storage.Search.CommonFolderQuery.groupByRating);

참고  이 예제에서 사진 라이브러리를 사용하지만 액세스 권한이 있고 storageFolder 개체로 표현될 수 있는 어떤 위치도 사용할 수 있습니다.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8

Namespace

Windows.Storage.Search
Windows::Storage::Search [C++]

Metadata

Windows.winmd

참고 항목

queryOptions class
Windows.Storage.storageFolder class

 

 

표시: