다음을 통해 공유


CommonFolderQuery 열거형

정의

쿼리 결과의 폴더로 파일을 그룹화하는 방법을 지정하고 쿼리가 단순하거나 깊은지 여부를 결정합니다. 심층 쿼리에 대한 쿼리 결과에는 지정된 옵션에 따라 폴더로 그룹화된 현재 폴더의 모든 하위 폴더에 있는 모든 파일이 포함됩니다.

public enum class CommonFolderQuery
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFolderQuery
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFolderQuery
var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery
Public Enum CommonFolderQuery
상속
CommonFolderQuery
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

필드

DefaultQuery 0

파일 탐색기 제공하는 보기와 유사하게 현재 폴더에 있는 폴더의 단순 목록입니다.

모든 스토리지 위치에 이 옵션을 사용할 수 있습니다.

GroupByAlbum 103

각 파일의 System.Music.AlbumTitle 속성에 따라 매년 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 System.Music.AlbumTitle에 대해 동일한 값을 가진 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByAlbumArtist 104

각 파일의 System.Music.AlbumArtist 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 System.Music.AlbumArtist에 대해 동일한 값을 가진 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByArtist 102

각 파일의 System.Music.Artist 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 System.Music.Artist에 대해 동일한 값을 가진 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByAuthor 110

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

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByComposer 105

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

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByGenre 106

각 파일의 System.Music.Genre 속성을 기반으로 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 System.Music.Genre에 대해 동일한 값을 가진 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByMonth 101

각 파일의 System.ItemDate 속성을 기반으로 매월 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 같은 달 내에 System.ItemDate 에 대한 값이 있는 모든 파일만 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByPublishedYear 107

각 파일의 System.Media.Year 속성에 따라 매년 가상 폴더로 파일을 그룹화합니다. 각 폴더에는 동일한 연도 내에 System.Media.Year 에 대한 값이 있는 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByRating 108

각 파일의 System.Rating 속성에 따라 등급(1개 star, 별 2개 등)을 기준으로 파일을 가상 폴더로 그룹화합니다. 각 폴더에는 System.Rating에 대해 동일한 값을 가진 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByTag 109

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

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByType 111

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

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

GroupByYear 100

각 파일의 System.ItemDate 속성에 따라 매년 가상 폴더로 파일을 그룹화합니다. 각 폴더에는 동일한 연도 내에 System.ItemDate 에 대한 값이 있는 모든(및 전용) 파일이 포함됩니다.

라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

설명

StorageFolder 클래스의 다음 메서드 중 하나를 호출할 때 CommonFolderQuery 열거형의 값을 사용합니다. CommonFolderQuery 열거형의 값을 사용하는 예제는 이러한 메서드에 대한 topics 참조하세요.

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

StorageFolder.IsCommonFolderQuerySupported 메서드를 호출하여 현재 폴더에 사용할 CommonFolderQuery 값을 사용할 수 있는지 여부를 확인합니다.

쿼리가 여러 값(예: System.Author)을 가질 수 있는 속성을 기반으로 파일을 가상 폴더로 그룹화하면 각 폴더가 여러 값 중 하나를 나타내기 때문에 특정 파일이 둘 이상의 가상 폴더에 나타날 수 있습니다.

쿼리에서 파일을 그룹화하기 위해 사용하는 속성에 대한 값이 없는 파일은 일반적으로 쿼리 결과에서 제외됩니다.

적용 대상

추가 정보