StorageFolderQueryResult 클래스

  • 참조

정의

네임스페이스:
Windows.Storage.Search
편집

쿼리 중인 폴더( StorageFolder로 표시됨)의 폴더(또는 파일 그룹)를 나열하는 쿼리 결과에 대한 액세스를 제공합니다. StorageFolderQueryResult를 사용하여 해당 폴더의 폴더 또는 파일 그룹을 열거할 수 있습니다.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
상속
Object Platform::Object IInspectable StorageFolderQueryResult
특성
ContractVersionAttribute
구현
IStorageQueryResultBase

Windows 요구 사항

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

예제

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

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

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

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

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

참고

KnownFolders.PicturesLibrary를 사용하여 라이브러리에 액세스하려면 사진 라이브러리 기능이 필요합니다. 기능 및 파일 액세스에 대한 자세한 내용은 파일 액세스 권한을 참조하세요.

설명

참고

으로 특성이 marshalling_behavior(agile)지정되지는 않지만 이 클래스는 Agile로 처리할 수 있습니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)을 참조하세요.

StorageFolder 또는 FolderInformation 개체에서 다음 메서드를 호출하여 StorageFolderQueryResult 개체를 가져올 수 있습니다.

storageFolderQueryResult 개체를 사용하는 방법을 보여 주는 더 많은 코드 예제는 폴더 열거형 샘플을 참조하세요.

StorageFolderQueryResult 개체를 가져와 위치의 폴더 또는 파일 그룹을 열거하려면 위치를 나타내는 storageFolder 를 가져와서 폴더 쿼리를 만들어야 합니다.

속성

Folder

StorageFolderQueryResult 개체를 만드는 데 원래 사용된 폴더를 가져옵니다. 이 폴더는 쿼리의 scope 나타냅니다.

메서드

ApplyNewQueryOptions(QueryOptions)

새 QueryOptions를 기반으로 쿼리 결과를 수정합니다.
FindStartIndexAsync(Object)

지정된 속성 값과 가장 일치하는 쿼리 결과에서 폴더의 인덱스를 검색합니다. 일치하는 속성은 QueryOptions.SortOrder 목록의 첫 번째 SortEntry에 의해 결정됩니다.
GetCurrentQueryOptions()

쿼리 결과를 확인하는 데 사용되는 쿼리 옵션을 검색합니다.
GetFoldersAsync()

결과 집합의 모든 폴더(또는 파일 그룹) 목록을 검색합니다.
GetFoldersAsync(UInt32, UInt32)

지정된 범위에서 폴더(또는 파일 그룹)를 검색합니다.
GetItemCountAsync()

쿼리 결과 집합의 폴더(또는 파일 그룹)의 수를 검색합니다.

이벤트

ContentsChanged

쿼리 중인 폴더에 파일이 추가, 삭제 또는 수정될 때 발생합니다. 이 이벤트는 GetFilesAsync 가 한 번 이상 호출된 후에만 발생합니다.
OptionsChanged

쿼리 옵션이 변경되면 발생합니다.

적용 대상

추가 정보