StorageItemQueryResult 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
쿼리 중인 폴더( StorageFolder로 표시됨)의 파일 및 폴더(또는 파일 그룹)를 포함한 모든 항목을 나열하는 쿼리 결과에 대한 액세스를 제공합니다. storageItemQueryResult를 사용하여 해당 StorageFolder의 파일 및 폴더를 열거할 수 있습니다.
public ref class StorageItemQueryResult sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageItemQueryResult final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageItemQueryResultPublic NotInheritable Class StorageItemQueryResult- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
참고
으로 특성이 marshalling_behavior(agile)지정되지는 않지만 이 클래스는 Agile로 처리할 수 있습니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)을 참조하세요.
StorageFolder 또는 FolderInformation 개체에서 다음 메서드를 호출하여 storageItemQueryResult 개체를 가져올 수 있습니다.
- StorageFolder.CreateItemQuery 메서드
- StorageFolder.CreateItemQueryWithOptions 메서드
- FolderInformation.CreateItemQuery 메서드
- FolderInformation.CreateItemQueryWithOptions 메서드 관련 코드 예제는 storageFileQueryResult, storageFolderQueryResult, 폴더 열거형 샘플 및 파일 검색 샘플을 참조하세요.
속성
| Folder |
StorageItemQueryResult 개체를 만드는 데 원래 사용된 폴더를 가져옵니다. 이 폴더는 쿼리의 scope 나타냅니다. |
메서드
| ApplyNewQueryOptions(QueryOptions) |
새 QueryOptions를 기반으로 쿼리 결과를 수정합니다. |
| FindStartIndexAsync(Object) |
지정된 속성 값과 가장 일치하는 쿼리 결과에서 항목의 인덱스를 검색합니다. 일치하는 속성은 QueryOptions.SortOrder 목록의 첫 번째 SortEntry에 의해 결정됩니다. |
| GetCurrentQueryOptions() |
쿼리 결과를 확인하는 데 사용되는 쿼리 옵션을 검색합니다. |
| GetItemCountAsync() |
쿼리 결과 집합의 항목 수를 검색합니다. |
| GetItemsAsync() |
쿼리 결과 집합의 모든 항목(파일 및 폴더) 목록을 검색합니다. |
| GetItemsAsync(UInt32, UInt32) |
지정된 범위의 항목(파일 및 폴더) 목록을 검색합니다. |
이벤트
| ContentsChanged |
쿼리 중인 폴더에서 항목이 추가, 삭제 또는 수정될 때 발생합니다. 이 이벤트는 GetItemsAsync가 한 번 이상 호출된 후에만 발생합니다. |
| OptionsChanged |
쿼리 옵션이 변경되면 발생합니다. |