다음을 통해 공유

StorageItemQueryResult.GetItemsAsync 메서드

  • 참조

정의

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

오버로드

GetItemsAsync()

쿼리 결과 집합의 모든 항목(파일 및 폴더) 목록을 검색합니다.
GetItemsAsync(UInt32, UInt32)

지정된 범위의 항목(파일 및 폴더) 목록을 검색합니다.

GetItemsAsync()

편집

쿼리 결과 집합의 모든 항목(파일 및 폴더) 목록을 검색합니다.

public:
 virtual IAsyncOperation<IVectorView<IStorageItem ^> ^> ^ GetItemsAsync() = GetItemsAsync;
/// [Windows.Foundation.Metadata.Overload("GetItemsAsyncDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<IStorageItem>> GetItemsAsync();
[Windows.Foundation.Metadata.Overload("GetItemsAsyncDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<IStorageItem>> GetItemsAsync();
function getItemsAsync()
Public Function GetItemsAsync () As IAsyncOperation(Of IReadOnlyList(Of IStorageItem))

반환

IAsyncOperation<IVectorView<IStorageItem>>

IAsyncOperation<IReadOnlyList<IStorageItem>>

이 메서드가 성공적으로 완료되면 항목의 목록( IVectorView 형식)을 반환합니다. 각 항목은 IStorageItem 형식이며 파일, 폴더 또는 파일 그룹을 나타냅니다.

이 목록에서 파일은 StorageFile 개체로 표시되고 폴더 또는 파일 그룹은 StorageFolder 개체로 표시됩니다.

특성
OverloadAttribute RemoteAsyncAttribute

추가 정보

적용 대상

GetItemsAsync(UInt32, UInt32)

편집

지정된 범위의 항목(파일 및 폴더) 목록을 검색합니다.

public:
 virtual IAsyncOperation<IVectorView<IStorageItem ^> ^> ^ GetItemsAsync(unsigned int startIndex, unsigned int maxNumberOfItems) = GetItemsAsync;
/// [Windows.Foundation.Metadata.Overload("GetItemsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<IStorageItem>> GetItemsAsync(uint32_t const& startIndex, uint32_t const& maxNumberOfItems);
[Windows.Foundation.Metadata.Overload("GetItemsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<IStorageItem>> GetItemsAsync(uint startIndex, uint maxNumberOfItems);
function getItemsAsync(startIndex, maxNumberOfItems)
Public Function GetItemsAsync (startIndex As UInteger, maxNumberOfItems As UInteger) As IAsyncOperation(Of IReadOnlyList(Of IStorageItem))

매개 변수

startIndex
UInt32

unsigned int

uint32_t

검색할 첫 번째 항목의 인덱스(0부터 시작)입니다. 이 매개 변수의 기본값은 0입니다.

maxNumberOfItems
UInt32

unsigned int

uint32_t

검색할 최대 항목 수입니다. -1을 사용하여 모든 항목을 검색합니다. 범위에 최대 수보다 적은 항목이 포함된 경우 범위의 모든 항목이 반환됩니다.

반환

IAsyncOperation<IVectorView<IStorageItem>>

IAsyncOperation<IReadOnlyList<IStorageItem>>

이 메서드가 성공적으로 완료되면 항목의 목록( IVectorView 형식)을 반환합니다. 각 항목은 IStorageItem 형식이며 파일, 폴더 또는 파일 그룹을 나타냅니다.

이 목록에서 파일은 StorageFile 개체로 표시되고 폴더 또는 파일 그룹은 StorageFolder 개체로 표시됩니다.

특성
OverloadAttribute RemoteAsyncAttribute

설명

두 유형의 스토리지 개체에서 IsOfType 메서드를 사용하여 항목이 StorageFile 또는 StorageFolder 개체인지 확인할 수 있습니다.

C#/C++/VB의 경우: 항목이 StorageFile 인지 StorageFolder인지 알고 나면 해당 개체와 관련된 속성 및 메서드에 액세스하기 위해 항목을 적절한 형식으로 캐스팅할 수 있습니다.

이 오버로드를 사용하여 필요한 폴더 하위 집합만 포함하는 쿼리 결과의 가상화된 뷰를 제공하여 시스템 성능을 향상시킵니다. 예를 들어 앱이 갤러리에 많은 항목을 표시하는 경우 이 범위를 사용하여 현재 사용자에게 표시되는 항목만 검색할 수 있습니다.

추가 정보

적용 대상