IStorageFolderQueryOperations.GetFoldersAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
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 형식)을 반환합니다.
- 특성
설명
이 오버로드를 사용하여 필요한 폴더 하위 집합만 포함하는 쿼리 결과의 가상 보기를 표시하여 시스템 성능 향상을 검색합니다.