내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

QueryOptions Class

저장소 폴더의 내용을 열거하기 위한 검색 쿼리의 매개 변수를 지정합니다.

구문


var queryOptions = new Windows.Storage.Search.QueryOptions();
var queryOptions = new Windows.Storage.Search.QueryOptions(query);
var queryOptions = new Windows.Storage.Search.QueryOptions(query, fileTypeFilter);

특성

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

멤버

QueryOptions클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

QueryOptions클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
QueryOptions() Creates an instance of the QueryOptions class for enumerating storage items, and initializes it with the following default settings: QueryOptions.FolderDepth gets FolderDepth.Shallow and QueryOptions.IndexerOption gets IndexerOption.DoNotUseIndexer.
QueryOptions(CommonFileQuery, IIterable(String)) Creates an instance of the QueryOptions class for enumerating files and initializes it with values provided by the specified CommonFileQuery and an optional file type filter that determines which files to include in query results.
QueryOptions(CommonFolderQuery) Creates an instance of the QueryOptions class for enumerating subfolders and initializes it with values based on the specified CommonFolderQuery.

 

메서드

The QueryOptions 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
LoadFromString Initializes the current instance of the QueryOptions class with search parameters specified by a string that was created by the SaveToString method.
SaveToString Converts the values of a QueryOptions object to a string that can be used to initialize the values of a QueryOptions object by calling LoadFromString.
SetPropertyPrefetch Specifies properties that the system should load in advance for all items in the query result set while the query is being executed (instead of retrieving them on a case-by-case basis).
SetThumbnailPrefetch Specifies the type and size of thumbnails that the system should start loading immediately when items are accessed (instead of retrieving them on a case-by-case basis).
StorageProviderIdFilter Gets the filter for storage provider identifiers.

 

속성

QueryOptions클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

ApplicationSearchFilter

읽기/쓰기Gets or sets an application-defined Advanced Query Syntax (AQS) string for filtering files by keywords or properties. This property is combined with the UserSearchFilter to create the query's search filter.

DateStackOption

읽기 전용Gets the unit of time used to group files into folders if the QueryOptions object was created with a CommonFolderQuery based on date.

FileTypeFilter

읽기 전용Gets a list of file name extensions used to filter the search results. If the list is empty, the results include all file types.

FolderDepth

읽기/쓰기Indicates whether the search query should produce a shallow view of the folder contents or a deep recursive view of all files and subfolder.

GroupPropertyName

읽기 전용Gets the name of the property used to group query results if the QueryOptions object was created using a CommonFolderQuery.

IndexerOption

읽기/쓰기Gets or sets a value that specifies whether the system index or the file system is used to retrieve query results.

Language

읽기/쓰기Gets or sets the Internet Engineering Task Force (IETF) language tag (BCP47 standard) that identifies the language associated with the query. This determines the language-specific algorithm used by the system to break the query into individual search tokens.

SortOrder

읽기 전용Gets the list of SortEntry structures that specify how to sort content (like files and subfolders) in query results.

UserSearchFilter

읽기/쓰기Gets or sets a user-defined Advanced Query Syntax (AQS) string for filtering files by keywords or properties. This property is combined with the ApplicationSearchFilter to create the query's search filter.

 

설명

액세스하여 StorageFolder로 가져올 수 있는 폴더에 대한 파일 쿼리를 만들 수 있습니다.

QueryOptionsCreateFileQueryWithOptions를 사용하면 다른 앱의 속성 처리기를 사용하는 속성을 가져올 수 있도록 하는 인덱싱된 지원되는 파일 쿼리를 만들 수 있습니다.

QueryOptions 사용 방법에 대한 자세한 코드 예제를 보려면 폴더 열거 샘플파일 시스템 검색 샘플을 참조하십시오.

속성에 액세스하는 방법에 대한 추가 코드 샘플을 보려면 파일 액세스 샘플을 참조하십시오.

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

예제

이 예제에서는 QueryOptions를 사용하여 한 위치에서 파일을 쿼리하는 방법을 보여줍니다.



// Set query options with filter and sort order for results
var fileTypeFilter = [".jpg", ".png", ".bmp", ".gif"];
var queryOptions = new Windows.Storage.Search.QueryOptions(search.CommonFileQuery.orderByName, fileTypeFilter);

// Create query and retrieve files
var query = Windows.Storage.KnownFolders.picturesLibrary.createFileQueryWithOptions(queryOptions);
query.getFilesAsync().done(function (files) {
    // Process results
    files.forEach(function (file) {
        // Process file
    });
});

앞의 예제에서는 PicturesLibrary를 통한 사진 라이브러리 기능에 의존하여 StorageFolder 개체를 가져옵니다. 파일 및 폴더에 액세스하는 방법에 대한 자세한 내용은 Windows 스토어 앱의 파일 액세스 및 권한을 참조하십시오.

이 예제에서는 시스템 인덱스에서 지원하는 파일 쿼리를 사용하여 다른 앱의 속성 처리기(예: Title 문서 속성)에 의존할 수 있는 속성을 검색하는 방법을 보여 줍니다.



// Create index backed file query and get results
var documentsLibrary = Windows.Storage.KnownFolders.documentsLibrary;
var fileTypeFilter = [".docx"];
var queryOptions = new Windows.Storage.Search.QueryOptions(Windows.Storage.Search.CommonFileQuery.orderByName, fileTypeFilter);
queryOptions.indexerOption = Windows.Storage.Search.IndexerOption.onlyUseIndexer;
var fileQuery = documentsLibrary.createFileQueryWithOptions(queryOptions);
fileQuery.getFilesAsync().then(function (files) {
    // Process resulting files
    if (files.size === 0) {
        // Perform tasks to handle no files found
    } else {
        // Access properties for each file
        files.forEach(function (file) {
            // Get document properties
            file.properties.getDocumentPropertiesAsync().done(function (documentProperties) {
                // Perform tasks with document properties
                var title = documentProperties.title;
            });
        });
    }
},
// Handle errors with an error function
function (error) {
    // Handle errors encountered while processing files
});

앞의 예제에서는 DocumentsLibrary를 통한 문서 라이브러리 기능에 의존하여 StorageFolder 개체를 가져옵니다. 파일 및 폴더에 액세스하는 방법에 대한 자세한 내용은 Windows 스토어 앱의 파일 액세스 및 권한을 참조하십시오.

이 예제에서는 file에 속성을 검색할 파일을 나타내는 StorageFile이 포함되어 있습니다.

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

Windows Phone 8[구현되지 않음, 설명 참조]

Namespace

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

Metadata

Windows.winmd

 

 

표시:
© 2014 Microsoft