다음을 통해 공유


IStorageFolderQueryOperations.GetFilesAsync 메서드

정의

오버로드

GetFilesAsync(CommonFileQuery)

지정된 쿼리(단순 열거형)를 기반으로 파일 목록을 검색합니다. 그러면 특정 시점에 파일의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

GetFilesAsync(CommonFileQuery, UInt32, UInt32)

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

GetFilesAsync(CommonFileQuery)

지정된 쿼리(단순 열거형)를 기반으로 파일 목록을 검색합니다. 그러면 특정 시점에 파일의 스냅샷 반환되며 이벤트를 통해 변경 내용을 추적할 수 없습니다.

public:
 IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync(CommonFileQuery query);
/// [Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync(CommonFileQuery const& query);
[Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync(CommonFileQuery query);
function getFilesAsync(query)
Public Function GetFilesAsync (query As CommonFileQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFile))

매개 변수

query
CommonFileQuery

수행할 파일 쿼리의 형식입니다.

반환

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

특성

추가 정보

적용 대상

GetFilesAsync(CommonFileQuery, UInt32, UInt32)

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

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

매개 변수

query
CommonFileQuery

수행할 파일 쿼리의 형식입니다.

startIndex
UInt32

unsigned int

uint32_t

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

maxItemsToRetrieve
UInt32

unsigned int

uint32_t

검색할 최대 파일 수입니다. -1을 사용하여 모든 파일을 검색합니다.

반환

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

특성

설명

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

추가 정보

적용 대상