StorageFile 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파일을 나타냅니다. 파일 및 해당 콘텐츠에 대한 정보와 파일을 조작하는 방법을 제공합니다.
public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProviderPublic NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
| 앱 기능 |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
예제
이 예제에서는 FileOpenPicker.PickSingleFileAsync를 사용하여 사용자가 선택하는 파일을 캡처하고 처리하는 파일 선택기를 호출하는 방법을 보여 줍니다.
var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
// Store file for future access
Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
// The user didn't pick a file
}
PickSingleFileAsync가 file 완료되면 선택한 파일을 StorageFile로 가져옵니다.
이 예제 openPicker 에서는 FileOpenPicker 개체를 포함합니다. 파일 선택기를 사용하는 방법에 대한 자세한 내용은 선택기로 파일 및 폴더 열기를 참조하세요.
fileToken 또한 FutureAccessList에서 파일을 검색하는 데 사용할 수 있는 식별자를 가져옵니다. 나중에 다시 액세스할 수 있도록 파일 및 폴더를 저장하는 방법에 대한 자세한 내용은 FutureAccessList, MostRecentlyUsedList 및 최근에 사용한 파일 및 폴더 추적을 참조하세요.
설명
일반적으로 비동기 메서드 및/또는 함수 호출의 결과로 StorageFile 개체에 액세스합니다. 예를 들어 GetFileFromPathAsync 와 GetFileFromApplicationUriAsync 정적 메서드는 모두 지정된 파일을 나타내는 StorageFile을 반환합니다.
또한 사용자가 파일(또는 파일)을 선택할 수 있도록 파일 선택기를 호출할 때마다 파일 선택기는 파일을 StorageFile로 반환합니다.
참고
StorageFile 개체는 ".lnk", ".url" 또는 ".wsh" 파일 형식인 파일을 나타낼 수 없습니다.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 2004 | 19041 | GetFileFromPathForUserAsync |
속성
| Attributes |
파일의 특성을 가져옵니다. |
| ContentType |
파일 내용의 MIME 형식을 가져옵니다. |
| DateCreated |
현재 파일을 만든 날짜와 시간을 가져옵니다. |
| DisplayName |
파일의 사용자에게 친숙한 이름을 가져옵니다. |
| DisplayType |
파일 형식에 대한 사용자에게 친숙한 설명을 가져옵니다. |
| FileType |
파일의 형식(파일 이름 확장명)을 가져옵니다. |
| FolderRelativeId |
파일의 식별자를 가져옵니다. 이 ID는 파일이 포함된 쿼리 결과 또는 StorageFolder 에 대해 고유하며 이름이 같은 항목을 구분하는 데 사용할 수 있습니다. |
| IsAvailable |
파일이 로컬인지, 로컬로 캐시되었는지 또는 다운로드할 수 있는지를 나타냅니다. |
| Name |
파일 이름 확장명을 포함하여 파일의 이름을 가져옵니다. |
| Path |
파일에 경로가 있는 경우 현재 파일의 전체 파일 시스템 경로를 가져옵니다. |
| Properties |
파일의 콘텐츠 관련 속성에 대한 액세스를 제공하는 개체를 가져옵니다. |
| Provider |
현재 파일을 저장하는 서비스에 대한 정보가 포함된 StorageProvider 개체를 가져옵니다. |
메서드
| CopyAndReplaceAsync(IStorageFile) |
지정된 파일을 현재 파일의 복사본으로 바꿉니다. |
| CopyAsync(IStorageFolder) |
지정된 폴더에 파일의 복사본을 만듭니다. |
| CopyAsync(IStorageFolder, String) |
지정된 폴더에 파일의 복사본을 만들고 복사본의 이름을 바꿉니다. |
| CopyAsync(IStorageFolder, String, NameCollisionOption) |
지정된 폴더에 파일의 복사본을 만들고 복사본의 이름을 바꿉니다. 이 메서드는 동일한 이름의 파일이 대상 폴더에 이미 있는 경우 수행할 작업도 지정합니다. |
| CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference) |
지정된 데이터 스트림을 나타내는 StorageFile 을 만듭니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 호출할 함수를 지정하여 앱이 주문형 데이터를 생성할 수 있습니다. |
| CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference) |
지정된 URI(Uniform Resource Identifier) 리소스의 데이터 스트림을 나타내는 StorageFile 을 만듭니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 앱이 주문형 데이터를 다운로드할 수 있습니다. |
| DeleteAsync() |
현재 파일을 삭제합니다. |
| DeleteAsync(StorageDeleteOption) |
선택적으로 항목을 영구적으로 삭제하여 현재 파일을 삭제합니다. |
| GetBasicPropertiesAsync() |
현재 파일의 기본 속성을 가져옵니다. |
| GetFileFromApplicationUriAsync(Uri) |
지정된 URI(Uniform Resource Identifier) 앱 리소스를 나타내는 StorageFile 개체를 가져옵니다. 샘플 URI의 예는 규모, 테마, 고대비 등에 맞게 조정된 이미지 및 자산 로드를 참조하세요. |
| GetFileFromPathAsync(String) |
지정된 경로의 파일을 나타내는 StorageFile 개체를 가져옵니다. |
| GetFileFromPathForUserAsync(User, String) |
지정된 사용자에 대한 파일 시스템의 절대 경로를 기반으로 StorageFile 개체를 가져옵니다. |
| GetParentAsync() |
현재 파일의 부모 폴더를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode) |
축소판 그림의 용도에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) |
축소판 그림의 목적과 요청된 크기에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
축소판 그림의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 축소판 그림으로 크기 조정된 이미지를 가져옵니다. |
| GetThumbnailAsync(ThumbnailMode) |
썸네일의 목적에 따라 결정되는 파일의 조정된 미리 보기 이미지를 검색합니다. |
| GetThumbnailAsync(ThumbnailMode, UInt32) |
썸네일의 목적과 요청된 크기에 따라 결정되는 파일의 조정된 썸네일 이미지를 검색합니다. |
| GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) |
썸네일의 목적, 요청된 크기 및 지정된 옵션에 따라 결정되는 파일의 조정된 썸네일 이미지를 검색합니다. |
| IsEqual(IStorageItem) |
현재 파일이 지정된 파일과 같은지 여부를 나타냅니다. |
| IsOfType(StorageItemTypes) |
현재 StorageFile 이 지정된 StorageItemTypes 값과 일치하는지 여부를 결정합니다. |
| MoveAndReplaceAsync(IStorageFile) |
현재 파일을 지정된 파일의 위치로 이동하고 해당 위치의 지정된 파일을 바꿉니다. |
| MoveAsync(IStorageFolder) |
현재 파일을 지정된 폴더로 이동합니다. |
| MoveAsync(IStorageFolder, String) |
현재 파일을 지정된 폴더로 이동하고 원하는 이름에 따라 파일 이름을 바꿉니다. |
| MoveAsync(IStorageFolder, String, NameCollisionOption) |
현재 파일을 지정된 폴더로 이동하고 원하는 이름에 따라 파일 이름을 바꿉니다. 또한 이 메서드는 이름이 같은 파일이 지정된 폴더에 이미 있는 경우 수행할 작업을 지정합니다. |
| OpenAsync(FileAccessMode) |
지정된 파일에 대해 지정된 옵션을 사용하여 임의 액세스 스트림을 엽니다. |
| OpenAsync(FileAccessMode, StorageOpenOptions) |
지정된 파일에 대해 지정된 옵션을 사용하여 임의 액세스 스트림을 엽니다. |
| OpenReadAsync() |
파일 내용을 읽기 위해 현재 파일을 통해 임의 액세스 스트림을 엽니다. |
| OpenSequentialReadAsync() |
파일 내용을 읽기 위해 현재 파일을 통해 순차 액세스 스트림을 엽니다. |
| OpenTransactedWriteAsync() |
트랜잭션-쓰기 작업에 사용할 수 있는 파일에 대한 임의 액세스 스트림을 엽니다. |
| OpenTransactedWriteAsync(StorageOpenOptions) |
지정된 옵션을 사용하여 트랜잭션-쓰기 작업에 사용할 수 있는 파일에 대한 임의 액세스 스트림을 엽니다. |
| RenameAsync(String) |
현재 파일의 이름을 바꿉니다. |
| RenameAsync(String, NameCollisionOption) |
현재 파일의 이름을 바꿉니다. 또한 이 메서드는 현재 파일의 위치에 있는 기존 항목의 이름이 같은 경우 수행할 작업을 지정합니다. |
| ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference) |
지정된 IStorageFile 개체에서 참조하는 파일의 내용을 새 데이터 스트림으로 바꿉니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 호출할 함수를 지정하여 앱이 주문형 데이터를 생성할 수 있습니다. |
| ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference) |
지정된 IStorageFile 개체에서 참조하는 파일의 내용을 지정된 URI(Uniform Resource Identifier)의 새 데이터 스트림으로 바꿉니다. 이 메서드를 사용하면 스트림을 나타내는 StorageFile 에 처음 액세스할 때 앱이 주문형 데이터를 다운로드할 수 있습니다. 데이터 스트림은 반환되는 StorageFile 을 통해 액세스되고 StorageFile 에 처음 액세스할 때 요청 시 데이터가 다운로드됩니다. 지정된 파일을 나타내는 IStorageFile 개체를 지정된 URI(Uniform Resource Identifier)의 스트림을 제공하는 새 StorageFile 로 바꿉니다. |