FileInformation 类

  • 参考

定义

命名空间:
Windows.Storage.BulkAccess
编辑

提供对 从 StorageFile 公开的属性的同步访问，并允许应用执行异步文件操作，例如复制、删除、移动和重命名。

public ref class FileInformation sealed : IStorageItemInformation, IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemPropertiesWithProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileInformation final : IStorageItemInformation, IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemPropertiesWithProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileInformation : IStorageItemInformation, IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemPropertiesWithProvider
Public NotInheritable Class FileInformation
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemInformation, IStorageItemPropertiesWithProvider
继承
Object Platform::Object IInspectable FileInformation
属性
ContractVersionAttribute
实现
IStorageItemInformation IStorageFile IStorageFile2 IStorageFilePropertiesWithAvailability IStorageItem IStorageItem2 IStorageItemProperties IStorageItemPropertiesWithProvider IInputStreamReference IRandomAccessStreamReference

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

可以通过调用 fileInformationFactory.getFilesAsync 方法之一来检索 FileInformation 对象列表。

属性

Attributes

获取文件的属性。
BasicProperties

获取一个 对象，该对象包含文件的基本属性信息。
ContentType

获取描述文件内容的字符串。
DateCreated

获取文件的创建日期。
DisplayName

获取 StorageFile 的用户友好名称。
DisplayType

获取 StorageFile 的显示类型。
DocumentProperties

获取一个 对象，该对象提供对 StorageFile 的文档属性（例如标题、作者姓名等）的访问权限。
FileType

获取文件类型。
FolderRelativeId

获取相对于同一文件夹中其他项唯一标识 StorageFile 的标识符。
ImageProperties

获取 StorageFile 的图像属性，例如标题、分级、拍摄图像的日期，

等等。
IsAvailable

指示当前文件是否已下载或可下载。
MusicProperties

获取与 StorageFile 关联的音乐属性，例如专辑名称、艺术家姓名、比特率等。
Name

获取 StorageFile 的名称。
Path

获取 StorageFile 的路径。
Properties

获取用于检索 StorageFile 属性的对象。
Provider

获取 StorageProvider 对象，该对象包含有关存储当前文件的服务的信息。
Thumbnail

获取与 StorageFile 关联的缩略图。
VideoProperties

获取一个 对象，该对象提供对 StorageFile 的视频属性（例如持续时间、分级、发布日期等）的访问。

方法

CopyAndReplaceAsync(IStorageFile)

将指定的 StorageFile 替换为当前文件的副本。
CopyAsync(IStorageFolder)

创建 StorageFile 的副本，并将其存储在指定的 StorageFolder 中。
CopyAsync(IStorageFolder, String)

创建 StorageFile 的副本，为其指定文件名，并将其存储在指定的 StorageFolder 中。
CopyAsync(IStorageFolder, String, NameCollisionOption)

创建 StorageFile 的副本，为其指定文件名，并将其存储在指定的 StorageFolder 中。 方法还指定在指定文件夹中已存在同名文件时要执行的操作。
DeleteAsync()

删除文件。
DeleteAsync(StorageDeleteOption)

删除文件，可以选择将已删除的文件移动到回收站。
GetBasicPropertiesAsync()

检索 StorageFile 的基本属性。
GetParentAsync()

获取当前文件的父文件夹。
GetThumbnailAsync(ThumbnailMode)

检索与 StorageFile 关联的缩略图。
GetThumbnailAsync(ThumbnailMode, UInt32)

检索与 StorageFile 关联的缩略图，并将其缩放到指定大小。
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)

根据指定的选项检索与 StorageFile 关联的缩略图。
IsEqual(IStorageItem)

指示当前文件是否与指定的存储项相同。
IsOfType(StorageItemTypes)

确定加载的 StorageFile 是否为指定类型。
MoveAndReplaceAsync(IStorageFile)

将当前 StorageFile 从其位置移动，并使用它替换指定的 StorageFile。
MoveAsync(IStorageFolder)

将 StorageFile 移动到指定的 StorageFolder。
MoveAsync(IStorageFolder, String)

将 StorageFile 移动到指定的文件夹，并为该文件指定文件名。
MoveAsync(IStorageFolder, String, NameCollisionOption)

将 StorageFile 移动到指定的文件夹，并为其指定文件名。 方法还指定在指定文件夹中已存在同名文件时要执行的操作。
OpenAsync(FileAccessMode)

在指定文件上打开具有指定选项的随机访问流。
OpenAsync(FileAccessMode, StorageOpenOptions)

在指定文件上打开具有指定选项的随机访问流。
OpenReadAsync()

通过 StorageFile 打开只读的随机访问流。
OpenSequentialReadAsync()

通过 StorageFile 打开只读的顺序访问流。
OpenTransactedWriteAsync()

打开可用于事务写入操作的文件的随机访问流。
OpenTransactedWriteAsync(StorageOpenOptions)

使用指定选项打开文件的随机访问流，该流可用于事务处理写入操作。
RenameAsync(String)

重命名 StorageFile。
RenameAsync(String, NameCollisionOption)

重命名 StorageFile，并指定在当前文件夹中已存在同名文件时要执行的操作。

事件

PropertiesUpdated

更新 StorageFile 的一个或多个属性时发生。
ThumbnailUpdated

当 StorageFile 的缩略图更新或质量更好的缩略图可用时触发。

适用于

另请参阅