이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
MSDN Library
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StorageFile Class

파일을 나타냅니다. 파일과 해당 내용, 그리고 파일을 조작하는 방법에 대한 정보를 제공합니다.

구문


/* 이 개체를 만들거나 액세스하는 방법은 설명을 참조하세요. */

특성

[Muse()]
[Version(0x06020000)]

구성원

StorageFile클래스에는 다음과 같은 유형의 구성원이 있습니다.

메서드

The StorageFile 클래스 다음 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음에서 메서드를 상속합니다. Object 클래스.

메서드설명
CopyAndReplaceAsync Replaces the specified file with a copy of the current file.
CopyAsync(IStorageFolder) Creates a copy of the file in the specified folder.
CopyAsync(IStorageFolder, String) Creates a copy of the file in the specified folder, using the desired name.
CopyAsync(IStorageFolder, String, NameCollisionOption) Creates a copy of the file in the specified folder, using the desired name. This method also specifies what to do if an existing file in the specified folder has the same name.
CreateStreamedFileAsync Creates a StorageFile to represent the specified stream of data. This method lets the app produce the data on-demand by specifying a function to be invoked when the StorageFile that represents the stream is first accessed.
CreateStreamedFileFromUriAsync Creates a StorageFile to represent a stream of data from the specified Uniform Resource Identifier (URI) resource. This method lets the app download the data on-demand when the StorageFile that represents the stream is first accessed.
DeleteAsync() Deletes the current file.
DeleteAsync(StorageDeleteOption) Deletes the current file, optionally deleting the item permanently.
GetBasicPropertiesAsync Gets the basic properties of the current file.
GetFileFromApplicationUriAsync Gets a StorageFile object to represent the specified Uniform Resource Identifier (URI) app resource.
GetFileFromPathAsync Gets a StorageFile object to represent the file at the specified path.
GetParentAsync Gets the parent folder of the current file.
GetScaledImageAsThumbnailAsync(ThumbnailMode) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail and the requested size.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Gets a scaled image as a thumbnail, determined by the purpose of the thumbnail, the requested size, and the specified options
GetThumbnailAsync(ThumbnailMode) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail.
GetThumbnailAsync(ThumbnailMode, UInt32) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail and the requested size.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions) Retrieves an adjusted thumbnail image for the file, determined by the purpose of the thumbnail, the requested size, and the specified options.
IsEqual Indicates whether the current file is equal to the specified file.
IsOfType Determines whether the current StorageFile matches the specified StorageItemTypes value.
MoveAndReplaceAsync Moves the current file to the location of the specified file and replaces the specified file in that location.
MoveAsync(IStorageFolder) Moves the current file to the specified folder.
MoveAsync(IStorageFolder, String) Moves the current file to the specified folder and renames the file according to the desired name.
MoveAsync(IStorageFolder, String, NameCollisionOption) Moves the current file to the specified folder and renames the file according to the desired name. This method also specifies what to do if a file with the same name already exists in the specified folder.
OpenAsync Opens a random-access stream over the file.
OpenReadAsync Opens a random-access stream over the current file for reading file contents.
OpenSequentialReadAsync Opens a sequential-access stream over the current file for reading file contents.
OpenTransactedWriteAsync Opens a random-access stream to the file that can be used for transacted-write operations.
RenameAsync(String) Renames the current file.
RenameAsync(String, NameCollisionOption) Renames the current file. This method also specifies what to do if an existing item in the current file's location has the same name.
ReplaceWithStreamedFileAsync Replaces the contents of the file referred to by the specified IStorageFile object with a new data stream. This method lets the app produce the data on-demand by specifying a function to be invoked when the StorageFile that represents the stream is first accessed.
ReplaceWithStreamedFileFromUriAsync Replaces the contents of the file referred to by the specified IStorageFile object with a new data stream of the specified Uniform Resource Identifier (URI). This method lets the app download the data on-demand when the StorageFile that represents the stream is first accessed.

 

속성

StorageFile클래스 다음 속성이 있습니다.

속성액세스 유형설명

Attributes

읽기 전용Gets the attributes of a file.

ContentType

읽기 전용Gets the MIME type of the contents of the file.

DateCreated

읽기 전용Gets the date and time when the current file was created.

DisplayName

읽기 전용Gets a user-friendly name for the file.

DisplayType

읽기 전용Gets a user-friendly description of the type of the file.

FileType

읽기 전용Gets the type (file name extension) of the file.

FolderRelativeId

읽기 전용Gets an identifier for the file. This ID is unique for the query result or StorageFolder that contains the file and can be used to distinguish between items that have the same name.

IsAvailable

읽기 전용Indicates if the file is local, is cached locally, or can be downloaded.

Name

읽기 전용Gets the name of the file including the file name extension.

Path

읽기 전용Gets the full file-system path of the current file, if the file has a path.

Properties

읽기 전용Gets an object that provides access to the content-related properties of the file.

Provider

읽기 전용Gets the StorageProvider object that contains info about the service that stores the current file.

 

설명

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

또한 사용자가 파일을 선택하도록 파일 선택기를 호출할 때마다 파일 선택기는 파일을 StorageFile로 반환합니다.

참고  StorageFile 개체는 파일 형식이 ".lnk", ".url" 또는 ".wsh" 파일을 나타낼 수 없습니다.

예제

이 예제에서는 FileOpenPicker.PickSingleFileAsync를 사용하여 선택을 사용하는 파일을 캡처하고 처리하는 방법을 보여 줍니다.



openPicker.pickSingleFileAsync().then(function (file) {
   if (file) {
       // Process picked file

       // Store file for future access
       var fileToken = Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.add(file);
   } else {
       // The user didn't pick a file
   }
});

PickSingleFileAsync가 완료된 후 file은 선택된 파일을 StorageFile로 가져옵니다.

이 예제에서 openPicker에는 FileOpenPicker 개체가 포함되어 있습니다. 파일 선택기를 사용하는 방법에 대한 자세한 내용은 FileOpenPicker빠른 시작: 파일 선택기로 파일에 액세스를 참조하십시오.

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

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱 전용]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱 전용]

지원되는 최소 전화

Windows Phone 8

네임스페이스

Windows.Storage
Windows::Storage [C++]

메타데이터

Windows.winmd

Capabilities

picturesLibrary
videosLibrary
musicLibrary
documentsLibrary

참고 항목

StorageFolder
IStorageFile
IStorageItem
IRandomAccessStreamReference
IInputStreamReference
IStorageItemProperties
IStorageItemProperties2
IStorageItem2
IStorageItemPropertiesWithProvider
IStorageFilePropertiesWithAvailability

 

 

표시:
© 2015 Microsoft