DownloadsFolder.CreateFolderForUserAsync Método

Definição

Namespace:

Windows.Storage

Sobrecargas

CreateFolderForUserAsync(User, String)	Cria uma nova subpasta dentro da pasta Downloads de um usuário específico.
CreateFolderForUserAsync(User, String, CreationCollisionOption)	Cria uma nova subpasta na pasta Downloads de um Usuário específico e especifica o que fazer se uma subpasta com o mesmo nome já existir na pasta Downloads.

CreateFolderForUserAsync(User, String)

Cria uma nova subpasta dentro da pasta Downloads de um usuário específico.

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)

Parâmetros

user

User

O Usuário para o qual a pasta é criada.

desiredName

String

Platform::String

winrt::hstring

O nome desejado da subpasta a ser criada.

Se uma subpasta com o nome especificado já existir, um nome semelhante, mas exclusivo, será usado. Por exemplo, se desiredName for "MyFolder" e uma subpasta com esse nome já existir na pasta Downloads, a nova subpasta será criada com um nome como "MyFolder (1)".

Retornos

IAsyncOperation<StorageFolder>

Quando esse método for concluído, ele retornará a nova subpasta como uma StorageFolder.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Confira também

• CreateFolderForUserAsync(User, String, CreationCollisionOption)
• StorageFolder

CreateFolderForUserAsync(User, String, CreationCollisionOption)

Cria uma nova subpasta na pasta Downloads de um Usuário específico e especifica o que fazer se uma subpasta com o mesmo nome já existir na pasta 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)

Parâmetros

user

User

O Usuário para o qual a pasta é criada.

desiredName

String

Platform::String

winrt::hstring

O nome desejado da subpasta a ser criada.

Se houver uma subpasta existente na pasta Downloads que já tenha o desiredName especificado, CreationCollisionOption especificada determinará como o Windows responde ao conflito.

option

CreationCollisionOption

O valor de enumeração que determina como o Windows responde se desiredName é o mesmo que o nome de uma subpasta existente na pasta Downloads.

Como o aplicativo só pode acessar pastas na pasta Downloads do Usuário especificado, você não pode especificar OpenIfExists ou ReplaceExisting para esse parâmetro.

Retornos

IAsyncOperation<StorageFolder>

Quando esse método for concluído, ele retornará a nova subpasta como uma StorageFolder.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Confira também

• CreateFolderForUserAsync(User, String)
• StorageFolder