DownloadsFolder.CreateFolderForUserAsync Método

Definición

Espacio de nombres:

Windows.Storage

Sobrecargas

CreateFolderForUserAsync(User, String)	Crea una nueva subcarpeta dentro de la carpeta Descargas de un usuario específico.
CreateFolderForUserAsync(User, String, CreationCollisionOption)	Crea una nueva subcarpeta en la carpeta Descargas de un usuario específico y especifica qué hacer si ya existe una subcarpeta con el mismo nombre en la carpeta Descargas.

CreateFolderForUserAsync(User, String)

Crea una nueva subcarpeta dentro de la carpeta Descargas de un usuario 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

Usuario para el que se crea la carpeta.

desiredName

String

Platform::String

winrt::hstring

Nombre deseado de la subcarpeta que se va a crear.

Si ya existe una subcarpeta con el nombre especificado, se usará un nombre similar pero único. Por ejemplo, si desiredName es "MyFolder" y una subcarpeta por ese nombre ya existe en la carpeta Descargas, la nueva subcarpeta se creará con un nombre como "MyFolder (1)" en su lugar.

Devoluciones

IAsyncOperation<StorageFolder>

Cuando se completa este método, devuelve la nueva subcarpeta como storageFolder.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Consulte también

• CreateFolderForUserAsync(User, String, CreationCollisionOption)
• StorageFolder

CreateFolderForUserAsync(User, String, CreationCollisionOption)

Crea una nueva subcarpeta en la carpeta Descargas de un usuario específico y especifica qué hacer si ya existe una subcarpeta con el mismo nombre en la carpeta Descargas.

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

Usuario para el que se crea la carpeta.

desiredName

String

Platform::String

winrt::hstring

Nombre deseado de la subcarpeta que se va a crear.

Si hay una subcarpeta existente en la carpeta Descargas que ya tiene el desiredName especificado, el objeto CreationCollisionOption especificado determina cómo Responde Windows al conflicto.

option

CreationCollisionOption

Valor de enumeración que determina cómo responde Windows si desiredName es el mismo que el nombre de una subcarpeta existente en la carpeta Descargas.

Dado que la aplicación solo puede acceder a las carpetas de la carpeta Descargas del usuario especificado, no puede especificar OpenIfExists ni ReplaceExisting para este parámetro.

Devoluciones

IAsyncOperation<StorageFolder>

Cuando se completa este método, devuelve la nueva subcarpeta como storageFolder.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v2.0)

Consulte también

• CreateFolderForUserAsync(User, String)
• StorageFolder