다음을 통해 공유


IStorageFolderQueryOperations.GetFoldersAsync 메서드

정의

오버로드

GetFoldersAsync(CommonFolderQuery)

지정된 폴더 쿼리를 기반으로 폴더 및 파일 그룹 목록을 검색합니다. 그러면 특정 시점에 폴더 또는 파일 그룹의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

폴더 쿼리를 기반으로 이 폴더의 폴더 범위를 비동기적으로 검색합니다. 그러면 특정 시점에 폴더 또는 파일 그룹의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

GetFoldersAsync(CommonFolderQuery)

지정된 폴더 쿼리를 기반으로 폴더 및 파일 그룹 목록을 검색합니다. 그러면 특정 시점에 폴더 또는 파일 그룹의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

public:
 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query);
/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query);
[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query);
function getFoldersAsync(query)
Public Function GetFoldersAsync (query As CommonFolderQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

매개 변수

query
CommonFolderQuery

수행할 폴더 쿼리의 유형입니다.

반환

이 메서드가 성공적으로 완료되면 StorageFolder 개체로 표시되는 파일 그룹의 폴더 목록(IVectorView 형식)을 반환합니다.

특성

추가 정보

적용 대상

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

폴더 쿼리를 기반으로 이 폴더의 폴더 범위를 비동기적으로 검색합니다. 그러면 특정 시점에 폴더 또는 파일 그룹의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

public:
 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve);
/// [Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);
[Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query, uint startIndex, uint maxItemsToRetrieve);
function getFoldersAsync(query, startIndex, maxItemsToRetrieve)
Public Function GetFoldersAsync (query As CommonFolderQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))

매개 변수

query
CommonFolderQuery

수행할 폴더 쿼리의 유형입니다.

startIndex
UInt32

unsigned int

uint32_t

범위 내 첫 번째 폴더 또는 파일 그룹의 인덱스(0부터 시작)입니다. 이 매개 변수의 기본값은 0입니다.

maxItemsToRetrieve
UInt32

unsigned int

uint32_t

검색할 폴더 또는 파일 그룹의 최대 수입니다. -1을 사용하여 모든 폴더 또는 파일 그룹을 검색합니다.

반환

이 메서드가 성공적으로 완료되면 StorageFolder 개체로 표시되는 파일 그룹의 폴더 목록(IVectorView 형식)을 반환합니다.

특성

설명

이 오버로드를 사용하여 필요한 폴더 하위 집합만 포함하는 쿼리 결과의 가상 보기를 표시하여 시스템 성능 향상을 검색합니다.

추가 정보

적용 대상