DownloadsFolder.CreateFileAsync 方法

定义

重载

CreateFileAsync(String)

在 Downloads 文件夹中创建一个新文件。

CreateFileAsync(String, CreationCollisionOption)

在 Downloads 文件夹中创建一个新文件,并指定在“下载”文件夹中已存在同名文件时要执行的操作。

CreateFileAsync(String)

在 Downloads 文件夹中创建一个新文件。

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName);
/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);
function createFileAsync(desiredName)
Public Shared Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)

参数

desiredName
String

Platform::String

winrt::hstring

要创建的文件的所需名称。

如果已存在具有指定名称的文件,则将使用类似但唯一的名称。 例如,如果 desiredName 为“MyFileName.jpg”,并且“下载”文件夹中已存在一个按该名称命名的文件,则将使用“MyFileName (1) .jpg”之类的名称创建新文件。

返回

此方法完成后,它将新文件作为 StorageFile 对象返回。

属性

另请参阅

适用于

CreateFileAsync(String, CreationCollisionOption)

在 Downloads 文件夹中创建一个新文件,并指定在“下载”文件夹中已存在同名文件时要执行的操作。

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption option);
function createFileAsync(desiredName, option)
Public Shared Function CreateFileAsync (desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)

参数

desiredName
String

Platform::String

winrt::hstring

要创建的文件的所需名称。

如果当前文件夹中已有具有指定 desiredName 的现有文件,则指定的 CreationCollisionOption 将确定 Windows 如何响应冲突。

option
CreationCollisionOption

如果 desiredName 与当前文件夹中现有文件的名称相同,则确定 Windows 的响应方式的枚举值。

由于应用只能访问其创建的 Downloads 文件夹中的文件,因此不能为此参数指定 OpenIfExistsReplaceExisting

返回

此方法完成后,它将新文件作为 StorageFile 对象返回。

属性

另请参阅

适用于