StorageFolder.AreQueryOptionsSupported(QueryOptions) 메서드

정의

네임스페이스:

Windows.Storage

현재 폴더가 지정된 QueryOptions를 지원하는지 여부를 나타냅니다.

public:
 virtual bool AreQueryOptionsSupported(QueryOptions ^ queryOptions) = AreQueryOptionsSupported;

bool AreQueryOptionsSupported(QueryOptions const& queryOptions);

public bool AreQueryOptionsSupported(QueryOptions queryOptions);

function areQueryOptionsSupported(queryOptions)

Public Function AreQueryOptionsSupported (queryOptions As QueryOptions) As Boolean

매개 변수

queryOptions

QueryOptions

검사 QueryOptions입니다.

반환

Boolean

bool

True이면 폴더 또는 파일 그룹이 지정된 QueryOptions를 지원합니다. 그렇지 않으면 false입니다.

구현

AreQueryOptionsSupported(QueryOptions)

설명

QueryOptions 를 사용하면 해당 폴더 및 하위 폴더에 파일의 쿼리 결과 개체를 만드는 데 사용할 수 있는 조건을 지정하여 폴더 및 해당 하위 폴더의 파일을 열거할 수 있습니다. CommonFileQuery 및 CommonFolderQuery 열거형은 파일 및 폴더를 필터링하고 열거하는 데 사용되는 가장 일반적인 조건 중 일부를 나타냅니다.

AreQueryOptionsSupported 메서드를 사용하여 지정하려는 QueryOptions 를 현재 폴더에 사용할 수 있는지 확인합니다. IsCommonFileQuerySupported 또는 IsCommonFolderQuerySupported를 각각 호출하여 특정 CommonFileQuery 또는 CommonFolderQuery 값을 사용할 수 있는지 여부를 검사 수도 있습니다.

사용할 수 있는 특정 옵션은 열거하려는 파일 또는 폴더의 위치에 따라 달라집니다. 라이브러리 또는 홈 그룹 내에 있는 폴더 및 파일의 경우 QueryOptions의 조합을 사용할 수 있습니다.

라이브러리 또는 홈 그룹 외부의 폴더 및 파일은 옵션의 하위 집합만 지원합니다.

• 최상위 파일 또는 폴더(단순 쿼리라고도 함)만 열거하는 쿼리의 경우 다음 세 가지 방법 중 하나로 QueryOptions 개체를 만듭니다.

  • 기본 QueryOptions() 생성자를 호출합니다.
  • QueryOptions(CommonFolderQuery) 생성자를 호출하고 CommonFolderQuery를 지정합니다. DefaultQuery.
  • QueryOptions(CommonFileQuery, IIterable(String)) 생성자를 호출하고 CommonFileQuery를 지정합니다. DefaultQuery. 이 생성자를 사용할 때 필터링할 파일 형식을 계속 지정할 수 있습니다.

• 현재 폴더 및 해당 하위 폴더(심층 쿼리라고도 함) 내의 모든 파일을 열거하는 쿼리의 경우 다음 두 가지 방법 중 하나로 QueryOptions 개체를 만듭니다.

  • QueryOptions(CommonFolderQuery) 생성자를 호출하고 CommonFileQuery를 지정합니다. OrderByName 또는 CommonFileQuery. OrderBySearchRank.
  • QueryOptions(CommonFileQuery, IIterable(String)) 생성자를 호출하고 CommonFileQuery를 지정합니다. OrderByName 또는 CommonFileQuery. OrderBySearchRank. 이 생성자를 사용할 때 필터링할 파일 형식을 계속 지정할 수 있습니다.

Windows Server 2012의 경우 인덱서 구성 요소는 기본적으로 설치되지 않으므로 일부 QueryOptions, CommonFileQuery 값 및 CommonFolderQuery 값을 사용하려면 인덱서 구성 요소를 설치해야 합니다.