DownloadsFolder.CreateFileForUserAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| CreateFileForUserAsync(User, String) |
在特定 用户的“下载”文件夹中创建一个新文件。 |
| CreateFileForUserAsync(User, String, CreationCollisionOption) |
在特定 用户的“下载”文件夹中创建一个新文件，并指定“下载”文件夹中已存在同名文件时要执行的操作。 |
CreateFileForUserAsync(User, String)
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);function createFileForUserAsync(user, desiredName)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFile)参数
- desiredName
-
String
Platform::String
winrt::hstring
要创建的文件的所需名称。
如果已存在具有指定名称的文件，则将使用类似但唯一的名称。 例如，如果 desiredName 为“MyFileName.jpg”，并且“下载”文件夹中已存在一个按该名称命名的文件，则将使用“MyFileName (1) .jpg”之类的名称创建新文件。
返回
此方法完成后，它将新文件作为 StorageFile 对象返回。
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10586.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v2.0 中引入)
|
另请参阅
适用于
CreateFileForUserAsync(User, String, CreationCollisionOption)
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);function createFileForUserAsync(user, desiredName, option)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)参数
- desiredName
-
String
Platform::String
winrt::hstring
要创建的文件的所需名称。
如果当前文件夹中已有具有指定 desiredName 的现有文件，则指定的 CreationCollisionOption 将确定 Windows 如何响应冲突。
- option
- CreationCollisionOption
如果 desiredName 与当前文件夹中现有文件的名称相同，则确定 Windows 的响应方式的枚举值。
由于应用只能访问指定 用户的“下载”文件夹中的文件，因此不能为此参数指定 OpenIfExists 或 ReplaceExisting 。
返回
此方法完成后，它将新文件作为 StorageFile 对象返回。
- 属性
Windows 要求
| 设备系列 |
Windows 10 (在 10.0.10586.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v2.0 中引入)
|