StorageFolder 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
폴더 및 해당 콘텐츠를 관리하고 해당 폴더에 대한 정보를 제공합니다.
public ref class StorageFolder sealed : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolder final : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperations[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolder : IStorageFolder, IStorageFolder2, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider, IStorageFolderQueryOperationsPublic NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
| 앱 기능 |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
설명
일반적으로 StorageFolder 개체를 비동기 메서드 호출의 반환 값으로 가져옵니다. 예를 들어 정적 메서드 GetFolderFromPathAsync 는 지정된 폴더를 나타내는 StorageFolder를 반환합니다.
사용자가 폴더를 선택할 수 있도록 파일 선택기를 호출하면 파일 선택기가 폴더를 StorageFolder로 반환합니다.
현재 "MoveAsync" 또는 유사한 메서드가 없습니다. 폴더를 이동하는 간단한 구현 중 하나는 원하는 폴더를 가져와 원하는 위치에 복사한 다음 원래 폴더를 삭제하는 것입니다.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1803 | 17134 | TryGetChangeTracker |
| 2004 | 19041 | GetFolderFromPathForUserAsync |
속성
| Attributes |
현재 폴더의 특성을 가져옵니다. |
| DateCreated |
현재 폴더가 만들어진 날짜와 시간을 가져옵니다. |
| DisplayName |
현재 폴더의 사용자에게 친숙한 이름을 가져옵니다. |
| DisplayType |
폴더 형식에 대한 사용자에게 친숙한 설명을 가져옵니다. 예를 들면 입니다 |
| FolderRelativeId |
현재 폴더의 식별자를 가져옵니다. 이 ID는 현재 폴더 또는 파일 그룹을 포함하는 쿼리 결과 또는 StorageFolder 에 대해 고유하며 이름이 같은 항목을 구분하는 데 사용할 수 있습니다. |
| Name |
현재 폴더의 이름을 가져옵니다. |
| Path |
경로를 사용할 수 있는 경우 파일 시스템에서 현재 폴더의 전체 경로를 가져옵니다. |
| Properties |
현재 폴더의 콘텐츠 관련 속성에 대한 액세스를 제공하는 개체를 가져옵니다. |
| Provider |
현재 폴더를 저장하는 서비스에 대한 정보가 포함된 StorageProvider 개체를 가져옵니다. |
메서드
| AreQueryOptionsSupported(QueryOptions) |
현재 폴더가 지정된 QueryOptions를 지원하는지 여부를 나타냅니다. |
| CreateFileAsync(String) |
현재 폴더에 지정된 이름의 새 파일을 만듭니다. |
| CreateFileAsync(String, CreationCollisionOption) |
현재 폴더에 새 파일을 만듭니다. 또한 이 메서드는 이름이 같은 파일이 현재 폴더에 이미 있는 경우 수행할 작업을 지정합니다. |
| CreateFileQuery() |
현재 폴더의 파일이 포함된 쿼리 결과 개체를 가져옵니다. |
| CreateFileQuery(CommonFileQuery) |
현재 폴더의 파일이 포함된 쿼리 결과 개체를 가져옵니다. 또한 쿼리 인수의 값이 CommonFileQuery.DefaultQuery 이외의 값인 경우 현재 폴더의 하위 폴더에서 파일을 가져옵니다. 파일은 지정된 CommonFileQuery에 따라 정렬됩니다. |
| CreateFileQueryWithOptions(QueryOptions) |
현재 폴더의 파일을 포함하고 필요에 따라 현재 폴더의 하위 폴더에 있는 쿼리 결과 개체를 가져옵니다. 결과는 지정된 QueryOptions를 기반으로 합니다. |
| CreateFolderAsync(String) |
현재 폴더에 지정된 이름을 사용하여 새 하위 폴더를 만듭니다. |
| CreateFolderAsync(String, CreationCollisionOption) |
현재 폴더에 지정된 이름을 사용하여 새 하위 폴더를 만듭니다. 또한 이 메서드는 이름이 같은 하위 폴더가 현재 폴더에 이미 있는 경우 수행할 작업을 지정합니다. |
| CreateFolderQuery() |
현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. |
| CreateFolderQuery(CommonFolderQuery) |
현재 폴더의 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값이면 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록을 가져옵니다. 파일은 CommonFolderQuery 열거형의 지정된 값을 기반으로 폴더로 그룹화됩니다. |
| CreateFolderQueryWithOptions(QueryOptions) |
현재 폴더의 하위 폴더와 필요에 따라 중첩된 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. 결과는 지정된 QueryOptions를 기반으로 합니다. |
| CreateItemQuery() |
현재 폴더의 파일 및 하위 폴더가 포함된 쿼리 결과 개체를 가져옵니다. |
| CreateItemQueryWithOptions(QueryOptions) |
현재 폴더의 파일 및 하위 폴더를 포함하고 필요에 따라 현재 폴더의 하위 폴더에 포함된 쿼리 결과 개체를 가져옵니다. 결과는 지정된 QueryOptions를 기반으로 합니다. |
| DeleteAsync() |
현재 폴더를 삭제합니다. |
| DeleteAsync(StorageDeleteOption) |
현재 폴더를 삭제합니다. 이 메서드는 폴더를 영구적으로 삭제할지 여부도 지정합니다. |
| GetBasicPropertiesAsync() |
현재 폴더 또는 파일 그룹의 기본 속성을 가져옵니다. |
| GetFileAsync(String) |
현재 폴더에서 지정된 이름의 파일을 가져옵니다. |
| GetFilesAsync() |
현재 폴더의 파일을 가져옵니다. |
| GetFilesAsync(CommonFileQuery) |
현재 폴더의 파일을 가져옵니다. 또한 쿼리 인수의 값이 CommonFileQuery.DefaultQuery 이외의 값인 경우 현재 폴더의 하위 폴더에서 파일을 가져옵니다. 파일은 CommonFileQuery 열거형의 지정된 값을 기준으로 정렬됩니다. |
| GetFilesAsync(CommonFileQuery, UInt32, UInt32) |
현재 폴더의 모든 파일 목록에서 인덱스 기반 파일 범위를 가져옵니다. 또한 쿼리 인수의 값이 CommonFileQuery.DefaultQuery 이외의 값인 경우 현재 폴더의 하위 폴더에서 파일을 가져옵니다. 파일은 CommonFileQuery 열거형의 지정된 값을 기준으로 정렬됩니다. |
| GetFolderAsync(String) |
현재 폴더에서 지정된 이름의 하위 폴더를 가져옵니다. |
| GetFolderFromPathAsync(String) |
파일 시스템에 지정된 절대 경로가 있는 폴더를 가져옵니다. |
| GetFolderFromPathForUserAsync(User, String) |
지정된 사용자에 대한 파일 시스템의 절대 경로를 기반으로 StorageFolder 를 가져옵니다. |
| GetFoldersAsync() |
현재 폴더의 하위 폴더를 가져옵니다. |
| GetFoldersAsync(CommonFolderQuery) |
현재 폴더의 하위 폴더를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값이면 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록을 가져옵니다. 파일은 CommonFolderQuery 열거형의 지정된 값을 기반으로 폴더로 그룹화됩니다. |
| GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) |
현재 폴더의 모든 하위 폴더 목록에서 인덱스 기반 폴더 범위를 가져옵니다. 쿼리 인수의 값이 CommonFolderQuery.DefaultQuery 이외의 값이면 현재 폴더의 하위 폴더에 있는 파일 그룹의 컨테이너를 나타내는 가상 폴더 목록을 가져옵니다. 파일은 CommonFolderQuery 열거형의 지정된 값을 기반으로 폴더로 그룹화됩니다. |
| GetIndexedStateAsync() |
현재 폴더의 인덱싱된 상태를 가져옵니다. |
| GetItemAsync(String) |
현재 폴더에서 지정된 이름의 파일 또는 폴더를 가져옵니다. |
| GetItemsAsync() |
현재 폴더의 파일 및 하위 폴더를 가져옵니다. |
| GetItemsAsync(UInt32, UInt32) |
현재 폴더의 모든 파일 및 하위 폴더 목록에서 인덱스 기반 파일 및 폴더 범위를 가져옵니다. |
| GetParentAsync() |
현재 폴더의 부모 폴더를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode) |
축소판 그림의 용도에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) |
축소판 그림의 목적과 요청된 크기에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
축소판 그림의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetThumbnailAsync(ThumbnailMode) |
현재 폴더의 축소판 그림 이미지를 가져오며 썸네일의 지정된 용도로 크기가 조정됩니다. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
현재 폴더의 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 요청된 크기로 조정됩니다. |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
현재 폴더에 대한 썸네일 이미지를 가져오며, 썸네일의 지정된 용도로 크기가 조정되고 지정된 옵션을 사용하여 요청된 크기로 조정됩니다. |
| IsCommonFileQuerySupported(CommonFileQuery) |
현재 폴더가 지정된 CommonFileQuery를 지원하는지 여부를 나타냅니다. |
| IsCommonFolderQuerySupported(CommonFolderQuery) |
현재 폴더가 지정된 CommonFolderQuery를 지원하는지 여부를 나타냅니다. |
| IsEqual(IStorageItem) |
현재 폴더가 지정된 폴더와 같은지 여부를 나타냅니다. |
| IsOfType(StorageItemTypes) |
현재 StorageFolder 가 지정된 StorageItemTypes 값과 일치하는지 여부를 나타냅니다. |
| RenameAsync(String) |
현재 폴더의 이름을 바꿉니다. |
| RenameAsync(String, NameCollisionOption) |
현재 폴더의 이름을 바꾸고 이름이 같은 폴더가 이미 있는 경우 수행할 작업을 지정합니다. |
| TryGetChangeTracker() | |
| TryGetItemAsync(String) |
현재 폴더에서 지정된 이름의 파일 또는 폴더를 가져옵니다. 지정된 파일 또는 폴더를 찾을 수 없는 경우 FileNotFoundException을 발생시키는 대신 null을 반환합니다. |