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