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