DownloadsFolder.CreateFileAsync Метод

Определение

Пространство имен:

Windows.Storage

Перегрузки

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".

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

IAsyncOperation<StorageFile>

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

Атрибуты

OverloadAttribute RemoteAsyncAttribute

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

• CreateFileAsync(String, CreationCollisionOption)

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 для этого параметра.

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

IAsyncOperation<StorageFile>

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

Атрибуты

OverloadAttribute RemoteAsyncAttribute

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

• CreateFileAsync(String)