DownloadsFolder 类

定义

命名空间:

Windows.Storage

在 Downloads 文件夹中创建文件和文件夹。

public ref class DownloadsFolder abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DownloadsFolder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class DownloadsFolder

Public Class DownloadsFolder

继承

Object Platform::Object IInspectable DownloadsFolder

属性

ContractVersionAttribute

Windows 要求

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

示例

可以在 Downloads 文件夹中创建一个空文件，如下所示：

StorageFile file = await Windows.Storage.DownloadsFolder.CreateFileAsync("sample.txt");
// Process file

createFileAsync 完成后，file获取新文件作为 StorageFile。

注解

此类是静态的，无法实例化。 请改为直接调用方法。

“下载”文件夹中的文件和文件夹权限

所有应用都可以在“下载”文件夹中创建文件和文件夹，并可以访问它们创建的文件。 但应用无法访问它们未创建的“下载”文件夹中的文件。

当你的应用在“下载”文件夹中创建文件时，除非用户显式授予其他应用访问权限，否则其他应用无法干扰或访问你的文件。 用户可以通过从文件选取器中选择文件，向另一个应用授予对文件的访问权限。 你的应用还可以使用文件选取器来访问它未创建的“下载”文件夹中的文件。 若要详细了解如何使用文件选取器打开文件，请参阅 使用选取器打开文件和文件夹。

无需功能即可创建或访问 Downloads 文件夹中的文件。 在 应用功能声明中详细了解功能。

若要详细了解应用可以访问的位置，请参阅 文件访问权限。

版本历史记录

Windows 版本	SDK 版本	已添加值
1511	10586	CreateFileForUserAsync (User，String)
1511	10586	CreateFileForUserAsync (User，String，CreationCollisionOption)
1511	10586	CreateFolderForUserAsync (User，String)
1511	10586	CreateFolderForUserAsync (User，String，CreationCollisionOption)

方法

CreateFileAsync(String)	在 Downloads 文件夹中创建一个新文件。
CreateFileAsync(String, CreationCollisionOption)	在 Downloads 文件夹中创建一个新文件，并指定在“下载”文件夹中已存在同名文件时要执行的操作。
CreateFileForUserAsync(User, String)	在特定 用户的“下载”文件夹中创建一个新文件。
CreateFileForUserAsync(User, String, CreationCollisionOption)	在特定 用户的“下载”文件夹中创建一个新文件，并指定“下载”文件夹中已存在同名文件时要执行的操作。
CreateFolderAsync(String)	在“下载”文件夹中创建新的子文件夹。
CreateFolderAsync(String, CreationCollisionOption)	在“下载”文件夹中创建新的子文件夹，并指定在“下载”文件夹中已存在同名的子文件夹时要执行的操作。
CreateFolderForUserAsync(User, String)	在特定 用户的“下载”文件夹中创建新的子文件夹。
CreateFolderForUserAsync(User, String, CreationCollisionOption)	在特定 用户的“下载”文件夹中创建新的子文件夹，并指定如果“下载”文件夹中已存在同名的子文件夹，该怎么办。