다음을 통해 공유


StorageFolder 클래스

정의

폴더 및 해당 콘텐츠를 관리하고 해당 폴더에 대한 정보를 제공합니다.

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, IStorageFolderQueryOperations
Public NotInheritable Class StorageFolder
Implements IStorageFolder, IStorageFolder2, IStorageFolderQueryOperations, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
상속
Object Platform::Object IInspectable StorageFolder
특성
구현

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

폴더 형식에 대한 사용자에게 친숙한 설명을 가져옵니다. 예를 들면 입니다 JPEG image.

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()

StorageFolder와 연결된 StorageLibraryChangeTracker가져옵니다.

TryGetItemAsync(String)

현재 폴더에서 지정된 이름의 파일 또는 폴더를 가져옵니다. 지정된 파일 또는 폴더를 찾을 수 없는 경우 FileNotFoundException을 발생시키는 대신 null을 반환합니다.

적용 대상

추가 정보