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


DownloadsFolder.CreateFolderForUserAsync Метод

Определение

Перегрузки

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

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

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

Атрибуты

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

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

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

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

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

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

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

Атрибуты

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

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

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

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