Поделиться через


DownloadsFolder.CreateFileAsync Метод

Определение

Перегрузки

CreateFileAsync(String)

Создает новый файл в папке Загрузки.

CreateFileAsync(String, CreationCollisionOption)

Создает новый файл в папке Загрузки и указывает, что делать, если файл с таким именем уже существует в папке Загрузки.

CreateFileAsync(String)

Создает новый файл в папке Загрузки.

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)

Создает новый файл в папке Загрузки и указывает, что делать, если файл с таким именем уже существует в папке Загрузки.

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

Значение перечисления, определяющее, как Windows отвечает, если desiredName совпадает с именем существующего файла в текущей папке.

Так как приложение может получать доступ только к файлам в созданной папке Downloads, вы не можете указать OpenIfExists или ReplaceExisting для этого параметра.

Возвращаемое значение

После завершения этого метода он возвращает новый файл в виде объекта StorageFile .

Атрибуты

См. также раздел

Применяется к