Windows.Storage 命名空间

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

提供用于管理文件、文件夹和应用程序设置的类。

有关如何使用Windows中的对象的信息。存储命名空间，请参阅以下部分。

类

名称	说明
AppDataPaths	AppDataPaths 根据 KNOWNFOLDERID 命名模式返回常用应用程序文件夹的路径。
ApplicationData	提供对应用程序数据存储的访问权限。应用程序数据由本地、漫游或临时的文件和设置组成。
ApplicationDataCompositeValue	表示必须以原子方式序列化和反序列化的相关应用设置。
ApplicationDataContainer	表示应用设置的容器。此类的方法和属性支持创建、删除、枚举和遍历容器层次结构。
ApplicationDataContainerSettings	提供对设置容器中的设置的访问权限。 ApplicationDataContainer.Values 属性返回可强制转换为此类型的对象。
CachedFileManager	允许应用管理文件的实时更新。
DownloadsFolder	在 Downloads 文件夹中创建文件和文件夹。
FileIO	提供用于读取和写入由 IStorageFile 类型对象表示的文件的帮助程序方法。
KnownFolders	提供对包含用户内容的常用位置的访问权限。这包括用户本地库中的内容（如文档、图片、音乐和视频）、家庭组、可移动设备和媒体服务器设备。
PathIO	提供使用文件的绝对路径或统一资源标识符（URI）读取和写入文件的帮助程序方法。
SetVersionDeferral	管理延迟集版本操作。
SetVersionRequest	当应用在其应用数据存储中设置应用程序数据的版本时提供数据。
StorageFile	表示文件。提供有关文件及其内容以及操作方式的信息。
StorageFolder	管理文件夹及其内容，并提供有关它们的信息。
StorageLibrary	允许从音乐或视频等库中添加和删除文件夹，并让你获取库中包含的文件夹列表。
StorageLibraryChange	表示对存储库中的项（如文档、音乐或视频库）的更改。
StorageLibraryChangeReader	使调用应用能够读取对存储库中项的更改。
StorageLibraryChangeTracker	提供可用于管理任何库（如文档、音乐或视频）或文件夹的更改跟踪的 API。
StorageLibraryChangeTrackerOptions	允许调用方在更改跟踪器上调用 EnableWithOptions，以选择跟踪所有更改，包括上次更改 ID，或仅跟踪上次更改 ID。
StorageLibraryLastChangeId	允许根据表示由给定 StorageFolder 或 StorageLibrary 的索引服务处理的最后一项更改的唯一值跟踪更改。
StorageProvider	包含有关存储文件和文件夹的服务的信息。文件和文件夹可以由本地文件系统或远程服务（如Microsoft OneDrive）存储。
StorageStreamTransaction	表示随机访问流的写入事务。
StreamedFileDataRequest	表示顺序访问输出流，该流指示通过调用 CreateStreamedFileAsync 或 ReplaceWithStreamedFileAsync 创建的 StorageFile 数据流的请求。
SystemAudioProperties	一个帮助程序对象，它为Windows音频文件属性提供索引名称。
SystemDataPaths	根据 KNOWNFOLDERID 命名模式获取一些常用的系统范围文件夹位置。
SystemGPSProperties	一个帮助程序对象，它为 GPS 文件属性提供索引名称。
SystemImageProperties	一个帮助程序对象，它为Windows图像文件属性提供索引名称。
SystemMediaProperties	一个帮助程序对象，它为Windows媒体文件属性提供索引名称。
SystemMusicProperties	一个帮助程序对象，它为Windows音乐文件属性提供索引名称。
SystemPhotoProperties	一个帮助程序对象，该对象为Windows照片文件属性提供索引名称。
SystemProperties	为通用Windows文件属性（如 System.Title）的索引名称提供字符串值，还引用为特定文件类型的属性（例如视频文件）提供索引名称的帮助程序对象。
SystemVideoProperties	一个帮助程序对象，它为视频文件属性提供索引名称。
UserDataPaths	返回常见用户数据文件夹的完整路径。用户数据文件夹基于 KNOWNFOLDERID 命名模式。

接口

名称	说明
IStorageFile	表示文件。提供有关文件及其内容的信息，以及操作方式。 Important 如果只想处理应用中的文件，请参阅 StorageFile 类。
IStorageFile2	表示文件。提供有关文件及其内容的信息，以及操作方式。 Important 如果只想处理应用中的文件，请参阅 StorageFile 类。
IStorageFilePropertiesWithAvailability	提供对 IsAvailable 属性的访问权限。
IStorageFolder	操作文件夹及其内容，并提供有关它们的信息。 Important 如果只想处理应用中的文件夹，请参阅 StorageFolder 类。
IStorageFolder2	操作文件夹及其内容，并提供有关它们的信息。 Important 如果只想处理应用中的文件夹，请参阅 StorageFolder 类。
IStorageItem	操作存储项（文件和文件夹）及其内容，并提供有关它们的信息。 Important 如果只想处理应用中的文件和文件夹，请参阅 StorageFile 和 StorageFolder 类。
IStorageItem2	操作存储项（文件和文件夹）及其内容，并提供有关它们的信息。 Important 如果只想处理应用中的文件和文件夹，请参阅 StorageFile 和 StorageFolder 类。
IStorageItemProperties	提供对项目（如文件和文件夹）的常见属性和内容属性的访问权限。
IStorageItemProperties2	提供对将缩放图像作为缩略图的方法的访问权限。
IStorageItemPropertiesWithProvider	提供对特定提供程序中存储项的常见属性和内容属性的访问权限。
IStreamedFileDataRequest	表示顺序访问输出流，该流指示通过调用 CreateStreamedFileAsync 或 ReplaceWithStreamedFileAsync 创建的 StorageFile 数据流的请求。

枚举

名称	说明
ApplicationDataCreateDisposition	指定用于创建应用程序数据容器或返回现有容器的选项。 ApplicationDataContainer.CreateContainer 方法使用此枚举。
ApplicationDataLocality	指定应用程序数据存储的类型。
CreationCollisionOption	指定在创建新文件或文件夹时，如果当前文件夹中已存在具有指定名称的文件或文件夹，该怎么办。
FileAccessMode	指定是以只读模式还是读/写模式访问文件。
FileAttributes	描述文件或文件夹的属性。
KnownFolderId	提供标识存储文件夹的值。
KnownFoldersAccessStatus	描述已知文件夹对单个功能的访问权限。
KnownLibraryId	提供标识存储库的值。
NameCollisionOption	指定在复制、移动或重命名文件或文件夹时，如果当前文件夹中已存在具有指定名称的文件或文件夹，该怎么办。
StorageDeleteOption	指定已删除的项目是移动到回收站还是永久删除。
StorageItemTypes	描述实现 IStorageItem 接口的项是文件还是文件夹。
StorageLibraryChangeType	描述存储库项发生的更改类型。
StorageOpenOptions	提供打开文件时要使用的选项。
StreamedFileFailureMode	指示无法流式传输数据的原因。

委托

名称	说明
ApplicationDataSetVersionHandler	表示处理请求以在应用程序数据存储中设置应用程序数据版本的方法。
StreamedFileDataRequestedHandler	表示首次访问该文件时将数据流式传输到 StorageFile 的方法。

注解

注释

应用框架兼容性：Windows。存储 API 可用于Windows 应用 SDK（WinUI 3）桌面应用和 Win32 桌面应用，而不仅仅是 UWP 应用。桌面应用可以通过 C#/WinRT 或 C++/WinRT 使用 StorageFile、 StorageFolder 和 ApplicationData 等类。某些 API（如文件选取器）需要在未打包的桌面应用中进行其他配置。有关详细信息，请参阅在桌面应用中调用Windows 运行时 API。

另请参阅

反馈

此页面是否有帮助？