DownloadsFolder.CreateFolderForUserAsync 方法

定义

命名空间:

Windows.Storage

重载

CreateFolderForUserAsync(User, String)	在特定 用户的“下载”文件夹中创建新的子文件夹。
CreateFolderForUserAsync(User, String, CreationCollisionOption)	在特定 用户的“下载”文件夹中创建新的子文件夹，并指定如果“下载”文件夹中已存在同名的子文件夹，该怎么办。

CreateFolderForUserAsync(User, String)

在特定 用户的“下载”文件夹中创建新的子文件夹。

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”，并且“下载”文件夹中已存在一个按该名称命名的子文件夹，则将改为使用“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)

在特定 用户的“下载”文件夹中创建新的子文件夹，并指定如果“下载”文件夹中已存在同名的子文件夹，该怎么办。

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

要创建的子文件夹的所需名称。

如果“下载”文件夹中的现有子文件夹已具有指定的 desiredName，则指定的 CreationCollisionOption 将确定 Windows 如何响应冲突。

option

CreationCollisionOption

如果 desiredName 与“下载”文件夹中现有子文件夹的名称相同，则确定 Windows 如何响应的枚举值。

由于应用只能访问指定 用户的 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