StorageFile 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示文件。 提供有关文件及其内容以及操作方式的信息。
public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProviderPublic NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider- 继承
- 属性
- 实现
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10240.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
|
| 应用功能 |
documentsLibrary
musicLibrary
picturesLibrary
videosLibrary
|
示例
此示例演示如何使用 FileOpenPicker.PickSingleFileAsync 调用文件选取器来捕获和处理用户选取的文件。
var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
// Store file for future access
Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
// The user didn't pick a file
}
PickSingleFileAsync 完成后，file获取选取的文件作为 StorageFile。
在示例中， openPicker 包含 FileOpenPicker 对象。 若要了解有关使用文件选取器的详细信息，请参阅 使用选取器打开文件和文件夹。
此外， fileToken 获取可用于从 FutureAccessList 检索文件的标识符。 若要详细了解如何存储文件和文件夹以便以后再次访问它们，请参阅 FutureAccessList、 MostRecentlyUsedList 和 跟踪最近使用的文件和文件夹。
注解
通常，访问 StorageFile 对象是异步方法和/或函数调用的结果。 例如，两个静态方法 GetFileFromPathAsync 和 GetFileFromApplicationUriAsync 都返回一个代表指定文件的 StorageFile。
此外，每当调用文件选取器以允许用户选取文件 (或) 文件选取器会将文件作为 StorageFile 返回。
注意
StorageFile 对象不能表示“.lnk”、“.url”或“.wsh”文件类型的文件。
版本历史记录
| Windows 版本 | SDK 版本 | 已添加值 |
|---|---|---|
| 2004 | 19041 | GetFileFromPathForUserAsync |
属性
| Attributes |
获取文件的属性。 |
| ContentType |
获取文件内容的 MIME 类型。 |
| DateCreated |
获取创建当前文件的日期和时间。 |
| DisplayName |
获取文件的用户友好名称。 |
| DisplayType |
获取文件类型的用户友好说明。 |
| FileType |
获取文件类型 (文件扩展名) 。 |
| FolderRelativeId |
获取文件的标识符。 此 ID 对于包含文件的查询结果或 StorageFolder 是唯一的，可用于区分具有相同名称的项。 |
| IsAvailable |
指示文件是本地文件、在本地缓存文件还是可下载文件。 |
| Name |
获取文件的名称，包括文件扩展名。 |
| Path |
如果文件具有路径，则获取当前文件的完整文件系统路径。 |
| Properties |
获取一个 对象，该对象提供对文件的内容相关属性的访问权限。 |
| Provider |
获取 StorageProvider 对象，该对象包含有关存储当前文件的服务的信息。 |