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

要建立之子資料夾所需的名稱。

如果 Downloads 資料夾中的現有子資料夾已經有指定的 desiredName，則指定的 CreationCollisionOption 會決定 Windows 如何回應衝突。

option

CreationCollisionOption

列舉值，決定 如果 desiredName 與 Downloads 資料夾中現有子資料夾的名稱相同，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