DownloadsFolder.CreateFileForUserAsync Метод

Определение

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

Windows.Storage

Перегрузки

CreateFileForUserAsync(User, String)	Создает новый файл в папке Downloads определенного пользователя.
CreateFileForUserAsync(User, String, CreationCollisionOption)	Создает новый файл в папке Downloads определенного пользователя и указывает, что делать, если файл с таким именем уже существует в папке Загрузки.

CreateFileForUserAsync(User, String)

Создает новый файл в папке Downloads определенного пользователя.

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)

Параметры

user

User

Пользователь, для которого создается файл.

desiredName

String

Platform::String

winrt::hstring

Требуемое имя создаваемого файла.

Если файл с указанным именем уже существует, будет использоваться аналогичное, но уникальное имя. Например, если параметр desiredName имеет значение "MyFileName.jpg", а файл с таким именем уже существует в папке "Загрузки", будет создан новый файл с таким именем, как "MyFileName (1).jpg".

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

IAsyncOperation<StorageFile>

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

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v2.0)

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

• CreateFileForUserAsync(User, String, CreationCollisionOption)
• StorageFile

CreateFileForUserAsync(User, String, CreationCollisionOption)

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

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)

Параметры

user

User

Пользователь, для которого создается файл.

desiredName

String

Platform::String

winrt::hstring

Требуемое имя создаваемого файла.

Если в текущей папке уже есть файл с указанным desiredName, указанный параметр CreationCollisionOption определяет, как Windows реагирует на конфликт.

option

CreationCollisionOption

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

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

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

IAsyncOperation<StorageFile>

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

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v2.0)

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

• CreateFileForUserAsync(User, String)
• StorageFile