IStorageFile 介面

定義

命名空間:

Windows.Storage

表示檔案。 提供檔案及其內容的相關資訊，以及操作方式。

重要

如果您只是想要在應用程式中使用檔案，請參閱 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.Storage.BulkAccess.FileInformation

Windows.Storage.StorageFile

屬性

ContractVersionAttribute GuidAttribute

實作

IStorageItem IInputStreamReference IRandomAccessStreamReference

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)

另請參閱

• IInputStreamReference
• IRandomAccessStreamReference
• IStorageItem
• StorageFile