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

StorageFolderQueryResult Class

storageFolder에서 제공하는 쿼리 중인 폴더 내 폴더 또는 파일 그룹을 나열하는 쿼리의 결과에 대한 액세스를 제공합니다.storageFolderQueryResult를 사용하여 폴더 또는 해당 폴더의 파일 그룹을 열거할 수 있습니다.

구문


var storageFolderQueryResult = storageFolder.createFolderQuery();

특성

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

멤버

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

이벤트

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

이벤트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 StorageFolderQueryResult 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
ApplyNewQueryOptions Modifies query results based on new QueryOptions.
FindStartIndexAsync Retrieves the index of the folder from the query results that most closely matches the specified property value. 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.
GetFoldersAsync() Retrieves a list of all the folders (or file groups) in the result set.
GetFoldersAsync(UInt32, UInt32) Retrieves folders (or file groups) in a specified range.
GetItemCountAsync Retrieves the number of folders (or file groups) in the set of query results.

 

속성

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

속성사용 권한Description

Folder

읽기 전용Gets the folder originally used to create the StorageFolderQueryResult object.

 

설명

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

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

위치에 있는 폴더나 파일 그룹을 열거할 StorageFolderQueryResult 개체를 가져오려면 위치를 나타내는 storageFolder를 가져온 다음 폴더 쿼리를 만들어야 합니다.

Windows Phone 8

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

예제

이 예제에서는 storageFolderQueryResult 개체에서 목록 폴더(또는 파일 그룹)를 가져오는 방법을 보여 줍니다.



// Get the Pictures library, then rearrange it by month
var picturesLibrary = Windows.Storage.KnownFolders.picturesLibrary;

// Set query options to create groups of files within result
var queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
var queryResult = picturesLibrary.createFolderQuery(Windows.Storage.Search.CommonFolderQuery.groupByMonth);
queryResult.getFoldersAsync().done(function(folders) {
    // Process file groups (or folders)

    // Create an array of promises that will asynchronously
    // retrieve the files for each file group
    var promises = folders.map(function (folder) {
        return folder.getFilesAsync();
    });

    // Aggregate the results of multiple asynchronous operations
    // so that they are returned after all are completed. This
    // ensures that the groups are displayed in order.
    WinJS.Promise.join(promises).done(function (folderContents) {
        // Process the contents of each file group (or folder)

        for (var i in folderContents) {
            // Process the group/folder at index i of folderContents

            // Display the group name
            var group = outputResultGroup(folders.getAt(i).name);
            // Display the items in the group 
            outputItems(group, folderContents[i]);
        }
    });
});

queryResult 변수는 쿼리의 기준을 충족하는 파일 그룹(또는 폴더)을 검색하는 데 사용되는 storageFolderQueryResult를 가져옵니다.

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

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

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

Namespace

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

Metadata

Windows.winmd

참고 항목

Windows.Storage.storageFolder.createFolderQuery methods
Windows.Storage.storageFolder.createFolderQueryWithOptions method
Windows.Storage.BulkAccess.folderInformation.createFolderQuery methods
Windows.Storage.BulkAccess.folderInformation.createFolderQueryWithOptions method

 

 

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft