StorageFile 클래스

정의

파일을 나타냅니다. 파일 및 해당 콘텐츠에 대한 정보와 파일을 조작하는 방법을 제공합니다.

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, IStorageItemPropertiesWithProvider
Public NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider
상속
Object Platform::Object IInspectable StorageFile
특성
구현

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
}

PickSingleFileAsyncfile 완료되면 선택한 파일을 StorageFile로 가져옵니다.

이 예제 openPicker 에서는 FileOpenPicker 개체를 포함합니다. 파일 선택기를 사용하는 방법에 대한 자세한 내용은 선택기로 파일 및 폴더 열기를 참조하세요.

fileToken 또한 FutureAccessList에서 파일을 검색하는 데 사용할 수 있는 식별자를 가져옵니다. 나중에 다시 액세스할 수 있도록 파일 및 폴더를 저장하는 방법에 대한 자세한 내용은 FutureAccessList, MostRecentlyUsedList최근에 사용한 파일 및 폴더 추적을 참조하세요.

설명

일반적으로 비동기 메서드 및/또는 함수 호출의 결과로 StorageFile 개체에 액세스합니다. 예를 들어 GetFileFromPathAsyncGetFileFromApplicationUriAsync 정적 메서드는 모두 지정된 파일을 나타내는 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 로 바꿉니다.

적용 대상

추가 정보