IStorageFile 인터페이스

정의

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

중요

앱에서 파일로 작업하려는 경우 StorageFile 클래스를 참조하세요.

public interface class IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
struct IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(4198457734, 16916, 17036, 166, 76, 20, 201, 172, 115, 21, 234)]
public interface IStorageFile : IStorageItem, IInputStreamReference, IRandomAccessStreamReference
Public Interface IStorageFile
Implements IInputStreamReference, IRandomAccessStreamReference, IStorageItem
파생
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
앱 기능
documentsLibrary musicLibrary picturesLibrary videosLibrary

속성

Attributes

스토리지 항목의 특성을 가져옵니다.

(다음에서 상속됨 IStorageItem)
ContentType

파일 내용의 MIME 형식을 가져옵니다.

DateCreated

현재 항목을 만든 날짜와 시간을 가져옵니다.

(다음에서 상속됨 IStorageItem)
FileType

파일의 형식(파일 이름 확장명)을 가져옵니다.

Name

파일 이름 확장명을 포함하는 항목의 이름을 가져옵니다(있는 경우).

(다음에서 상속됨 IStorageItem)
Path

항목에 경로가 있는 경우 항목의 전체 파일 시스템 경로를 가져옵니다.

(다음에서 상속됨 IStorageItem)

메서드

CopyAndReplaceAsync(IStorageFile)

지정된 파일을 현재 파일의 복사본으로 바꿉니다.

CopyAsync(IStorageFolder)

지정된 폴더에 파일의 복사본을 만듭니다.

CopyAsync(IStorageFolder, String)

원하는 이름을 사용하여 지정된 폴더에 파일의 복사본을 만듭니다.

CopyAsync(IStorageFolder, String, NameCollisionOption)

원하는 이름을 사용하여 지정된 폴더에 파일의 복사본을 만듭니다. 또한 이 메서드는 지정한 폴더의 기존 파일에 이름이 같은 경우 수행할 작업도 지정합니다.

DeleteAsync()

현재 항목을 삭제합니다.

(다음에서 상속됨 IStorageItem)
DeleteAsync(StorageDeleteOption)

현재 항목을 삭제하고 필요에 따라 영구적으로 삭제합니다.

(다음에서 상속됨 IStorageItem)
GetBasicPropertiesAsync()

현재 항목의 기본 속성(예: 파일 또는 폴더)을 가져옵니다.

(다음에서 상속됨 IStorageItem)
IsOfType(StorageItemTypes)

현재 IStorageItem 이 지정된 StorageItemTypes 값과 일치하는지 여부를 결정합니다.

(다음에서 상속됨 IStorageItem)
MoveAndReplaceAsync(IStorageFile)

현재 파일을 지정된 파일의 위치로 이동하고 해당 위치의 지정된 파일을 바꿉니다.

MoveAsync(IStorageFolder)

현재 파일을 지정된 폴더로 이동합니다.

MoveAsync(IStorageFolder, String)

현재 파일을 지정된 폴더로 이동하고 원하는 이름에 따라 파일 이름을 바꿉니다.

MoveAsync(IStorageFolder, String, NameCollisionOption)

현재 파일을 지정된 폴더로 이동하고 원하는 이름에 따라 파일 이름을 바꿉니다. 또한 이 메서드는 이름이 같은 파일이 지정된 폴더에 이미 있는 경우 수행할 작업을 지정합니다.

OpenAsync(FileAccessMode)

파일을 통해 임의 액세스 스트림을 엽니다.

OpenReadAsync()

임의 액세스를 위한 스트림을 엽니다.

(다음에서 상속됨 IRandomAccessStreamReference)
OpenSequentialReadAsync()

순차적 읽기 액세스를 위한 스트림을 엽니다.

(다음에서 상속됨 IInputStreamReference)
OpenTransactedWriteAsync()

파일에 쓰기 위한 트랜잭션된 임의 액세스 스트림을 엽니다.

RenameAsync(String)

현재 항목의 이름을 바꿉니다.

(다음에서 상속됨 IStorageItem)
RenameAsync(String, NameCollisionOption)

현재 항목의 이름을 바꿉니다. 또한 이 메서드는 현재 항목의 위치에 있는 기존 항목의 이름이 같은 경우 수행할 작업을 지정합니다.

(다음에서 상속됨 IStorageItem)

적용 대상

추가 정보