DownloadsFolder.CreateFolderForUserAsync Methode

Definition

Namespace:

Windows.Storage

Überlädt

CreateFolderForUserAsync(User, String)	Erstellt einen neuen Unterordner im Ordner Downloads eines bestimmten Benutzers.
CreateFolderForUserAsync(User, String, CreationCollisionOption)	Erstellt einen neuen Unterordner im Ordner Downloads eines bestimmten Benutzers und gibt an, was zu tun ist, wenn im Ordner Downloads bereits ein Unterordner mit demselben Namen vorhanden ist.

CreateFolderForUserAsync(User, String)

Erstellt einen neuen Unterordner im Ordner Downloads eines bestimmten Benutzers.

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)

Parameter

user

User

Der Benutzer , für den der Ordner erstellt wird.

desiredName

String

Platform::String

winrt::hstring

Der gewünschte Name des zu erstellenden Unterordners.

Wenn bereits ein Unterordner mit dem angegebenen Namen vorhanden ist, wird ein ähnlicher, aber eindeutiger Name verwendet. Wenn desiredName beispielsweise "MyFolder" ist und ein Unterordner mit diesem Namen bereits im Ordner Downloads vorhanden ist, wird der neue Unterordner stattdessen mit einem Namen wie "MyFolder (1)" erstellt.

Gibt zurück

IAsyncOperation<StorageFolder>

Nach Abschluss dieser Methode wird der neue Unterordner als StorageFolder zurückgegeben.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Weitere Informationen

• CreateFolderForUserAsync(User, String, CreationCollisionOption)
• StorageFolder

CreateFolderForUserAsync(User, String, CreationCollisionOption)

Erstellt einen neuen Unterordner im Ordner Downloads eines bestimmten Benutzers und gibt an, was zu tun ist, wenn im Ordner Downloads bereits ein Unterordner mit demselben Namen vorhanden ist.

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)

Parameter

user

User

Der Benutzer , für den der Ordner erstellt wird.

desiredName

String

Platform::String

winrt::hstring

Der gewünschte Name des zu erstellenden Unterordners.

Wenn im Ordner Downloads ein Unterordner vorhanden ist, der bereits den angegebenen desiredName enthält, bestimmt die angegebene CreationCollisionOption , wie Windows auf den Konflikt reagiert.

option

CreationCollisionOption

Der Enumerationswert, der bestimmt, wie Windows reagiert, wenn desiredName mit dem Namen eines vorhandenen Unterordners im Ordner Downloads übereinstimmt.

Da die App nur auf Ordner im Ordner Downloads des angegebenen Benutzers zugreifen kann, können Sie für diesen Parameter weder OpenIfExists noch ReplaceExisting angeben.

Gibt zurück

IAsyncOperation<StorageFolder>

Nach Abschluss dieser Methode wird der neue Unterordner als StorageFolder zurückgegeben.

Attribute

OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v2.0)

Weitere Informationen

• CreateFolderForUserAsync(User, String)
• StorageFolder