내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StorageItemQueryResult.GetItemsAsync(UInt32, UInt32) | getItemsAsync(UInt32, UInt32) Method

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

구문


storageItemQueryResult.getItemsAsync(startIndex, maxNumberOfItems).done( /* 성공 및 오류 처리기 */ );

매개 변수

startIndex

형식: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

검색할 첫 번째 항목의 인덱스(0부터 시작)입니다. 이 매개 변수는 기본적으로 0으로 설정됩니다.

maxNumberOfItems

형식: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

검색할 최대 항목 수입니다. 모든 항목을 검색하려면 -1을 사용합니다. 범위에 최대 개수보다 적은 항목이 들어 있을 경우 범위의 모든 항목이 반환됩니다.

반환 값

형식: IAsyncOperation<IVectorView>

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

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

설명

두 가지 형식의 저장소 개체에 대한 isOfType 메서드를 사용하여 항목이 storageFile인지 storageFolder 개체인지를 확인할 수 있습니다.

C#/C++/VB의 경우: 항목이 StorageFile인지 또는 StorageFolder인지 확인한 후 해당 개체 전용 속성과 메서드에 액세스하기 위해 항목을 적절한 형식으로 캐스팅할 수 있습니다.

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

Windows Phone 8

이 API는 구현되어 있지 않으므로 호출할 경우 예외가 throw됩니다. Windows Phone 런타임 API를 참조하십시오.

요구 사항

지원되는 최소 클라이언트

Windows 8

지원되는 최소 서버

Windows Server 2012

지원되는 최소 전화

Windows Phone 8[구현되지 않음, 설명 참조]

Namespace

Windows.Storage.Search
Windows::Storage::Search [C++]

Metadata

Windows.winmd

참고 항목

storageItemQueryResult class
storageItemQueryResult.getItemsAsync() method
Windows.Foundation.Collections.IVectorView interface
Windows.Storage.IStorageItem interface
Windows.Storage.IStorageItem.isOfType method
Windows.Storage.storageFile class
Windows.Storage.storageFolder class
StorageItemQueryResult

 

 

표시:
© 2014 Microsoft