DownloadsFolder.CreateFolderForUserAsync Метод

Определение

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

Windows.Storage

Перегрузки

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

CreateFolderForUserAsync(User, String)

Создает новую вложенную папку в папке Downloads определенного пользователя.

public:
 static IAsyncOperation<StorageFolder ^> ^ CreateFolderForUserAsync(User ^ user, Platform::String ^ desiredName);

/// [Windows.Foundation.Metadata.Overload("CreateFolderForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFolder> CreateFolderForUserAsync(User const& user, winrt::hstring const& desiredName);

[Windows.Foundation.Metadata.Overload("CreateFolderForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFolder> CreateFolderForUserAsync(User user, string desiredName);

function createFolderForUserAsync(user, desiredName)

Public Shared Function CreateFolderForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFolder)

Параметры

user

User

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

desiredName

String

Platform::String

winrt::hstring

Требуемое имя создаваемой вложенной папки.

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

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

IAsyncOperation<StorageFolder>

После завершения этого метода он возвращает новую вложенную папку в виде StorageFolder.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

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

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

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

• CreateFolderForUserAsync(User, String, CreationCollisionOption)
• StorageFolder

CreateFolderForUserAsync(User, String, CreationCollisionOption)

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

public:
 static IAsyncOperation<StorageFolder ^> ^ CreateFolderForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);

/// [Windows.Foundation.Metadata.Overload("CreateFolderForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFolder> CreateFolderForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);

[Windows.Foundation.Metadata.Overload("CreateFolderForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFolder> CreateFolderForUserAsync(User user, string desiredName, CreationCollisionOption option);

function createFolderForUserAsync(user, desiredName, option)

Public Shared Function CreateFolderForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFolder)

Параметры

user

User

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

desiredName

String

Platform::String

winrt::hstring

Требуемое имя создаваемой вложенной папки.

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

option

CreationCollisionOption

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

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

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

IAsyncOperation<StorageFolder>

После завершения этого метода он возвращает новую вложенную папку в виде StorageFolder.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

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

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

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

• CreateFolderForUserAsync(User, String)
• StorageFolder