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

StorageFileQueryResult Class

storageFolder 개체에서 제공하는 위치에 있는 파일의 쿼리 결과에 대한 액세스를 제공합니다.storageFileQueryResult를 사용하여 해당 storageFolder 위치에 있는 파일을 열거할 수 있습니다.

구문


var storageFileQueryResult = storageFolder.createFileQuery();

특성

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

멤버

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

이벤트

StorageFileQueryResult클래스에는 다음과 같은 이벤트가 있습니다.

이벤트Description
ContentsChanged Fires when a file is added to, deleted from, or modified in the folder being queried.
OptionsChanged Fires when the query options change.

 

메서드

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

메서드Description
ApplyNewQueryOptions Modifies query results based on new QueryOptions.
FindStartIndexAsync Retrieves the index of the file from the query results that most closely matches the specified property value (or file, if used with FileActivatedEventArgs.NeighboringFilesQuery). The property that is matched is determined by the first SortEntry of the QueryOptions.SortOrder list.
GetCurrentQueryOptions Retrieves the query options used to determine query results.
GetFilesAsync() Retrieves a list of all the files in the query result set.
GetFilesAsync(UInt32, UInt32) Retrieves a list of files in a specified range.
GetItemCountAsync Retrieves the number of files in the set of query results.
GetMatchingPropertiesWithRanges Gets matching file properties with corresponding text ranges.

 

속성

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

속성사용 권한Description

Folder

읽기 전용Gets the folder that was queried to create the StorageFileQueryResult object. This folder represents the scope of the query.

 

설명

storageFolder 또는 folderInformation 개체에서 다음 메서드를 호출하여 storageFileQueryResult 개체를 가져올 수 있습니다.

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

Windows Phone 8

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

예제

이 예제에서는 storageFileQueryResult 개체에서 파일 목록을 가져오는 방법을 보여 줍니다.



// 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
    });
});

query 변수는 쿼리의 기준을 충족하는 파일을 검색하는 데 사용되는 storageFileQueryResult를 가져옵니다.

참고  KnownFolders.PicturesLibrary를 사용하여 라이브러리에 액세스하려면 그림 라이브러리 기능이 필요합니다. 기능 및 파일 액세스에 대한 자세한 내용은 Windows 스토어 앱의 파일 액세스 및 권한을 참조하십시오.

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

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

Namespace

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

Metadata

Windows.winmd

참고 항목

Windows.Storage.storageFolder.createFileQuery methods
Windows.Storage.storageFolder.createFileQueryWithOptions method
Windows.Storage.BulkAccess.folderInformation.createFileQuery
Windows.Storage.BulkAccess.folderInformation.createFileQueryWithOptions

 

 

표시:
© 2014 Microsoft