CommonFileQuery 열거형

정의

네임스페이스:

Windows.Storage.Search

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

public enum class CommonFileQuery

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFileQuery

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFileQuery

var value = Windows.Storage.Search.CommonFileQuery.defaultQuery

Public Enum CommonFileQuery

상속

Enum

CommonFileQuery

특성

ContractVersionAttribute

Windows 요구 사항

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

필드

DefaultQuery	0	파일 탐색기 제공하는 목록과 유사하게 현재 폴더에 있는 파일의 단순 목록입니다. 모든 스토리지 위치에 이 옵션을 사용할 수 있습니다.
OrderByDate	5	System.ItemDate를 기준으로 정렬된 폴더 및 하위 폴더에 있는 파일의 깊고 평평한 목록입니다. 라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다. 참고 System.ItemDate 는 콘텐츠 형식에 따라 변경되는 계산 속성입니다. 예를 들어 사진에 대한 System.Photo.DateTaken 에 매핑됩니다.
OrderByMusicProperties	3	폴더 및 하위 폴더에 있는 파일의 깊고 평평한 목록으로, 음악 속성별로 정렬됩니다. 라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.
OrderByName	1	System.ItemNameDisplay별로 정렬된 폴더 및 해당 하위 폴더에 있는 파일의 깊고 평평한 목록입니다. 모든 스토리지 위치에 이 옵션을 사용할 수 있습니다.
OrderBySearchRank	4	System.Search.Rank, System.DateModified 순으로 정렬된 폴더 및 하위 폴더에 있는 파일의 깊고 평평한 목록입니다. 모든 스토리지 위치에 이 옵션을 사용할 수 있습니다.
OrderByTitle	2	System.Title을 기준으로 정렬된 폴더 및 하위 폴더에 있는 파일의 깊고 평평한 목록입니다. 라이브러리 또는 HomeGroup 폴더의 폴더에 대해서만 이 옵션을 사용할 수 있습니다.

설명

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

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions. QueryOptions(CommonFileQuery, IIterable(String)) 생성자를 사용하여 QueryOptions를 인스턴스화합니다.
• CreateItemQueryWithOptions. QueryOptions(CommonFileQuery, IIterable(String)) 생성자를 사용하여 QueryOptions를 인스턴스화합니다.
• GetFilesAsync(CommonFileQuery)
• GetFilesAsync(CommonFileQuery, UInt32, UInt32)

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

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

팁

쿼리에서 파일을 정렬하는 데 사용하는 속성에 대한 값이 없는 파일은 일반적으로 쿼리 결과에서 제외됩니다.

추가 정보

• 폴더 열거형 샘플(Windows 10)