StorageFolder.CreateFolderAsync Método

Definición

Espacio de nombres:

Windows.Storage

Sobrecargas

CreateFolderAsync(String)	Crea una nueva subcarpeta con el nombre especificado en la carpeta actual.
CreateFolderAsync(String, CreationCollisionOption)	Crea una nueva subcarpeta con el nombre especificado en la carpeta actual. Este método también especifica qué hacer si ya existe una subcarpeta con el mismo nombre en la carpeta actual.

CreateFolderAsync(String)

Crea una nueva subcarpeta con el nombre especificado en la carpeta actual.

public:
 virtual IAsyncOperation<StorageFolder ^> ^ CreateFolderAsync(Platform::String ^ desiredName) = CreateFolderAsync;

/// [Windows.Foundation.Metadata.Overload("CreateFolderAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFolder> CreateFolderAsync(winrt::hstring const& desiredName);

[Windows.Foundation.Metadata.Overload("CreateFolderAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFolder> CreateFolderAsync(string desiredName);

function createFolderAsync(desiredName)

Public Function CreateFolderAsync (desiredName As String) As IAsyncOperation(Of StorageFolder)

Parámetros

desiredName

String

Platform::String

winrt::hstring

Nombre de la nueva subcarpeta que se va a crear en la carpeta actual.

Devoluciones

IAsyncOperation<StorageFolder>

Cuando se completa este método, devuelve una clase StorageFolder que representa la nueva subcarpeta.

Implementaciones

M:Windows.Storage.IStorageFolder.CreateFolderAsync(System.String) M:Windows.Storage.IStorageFolder.CreateFolderAsync(Platform::String) M:Windows.Storage.IStorageFolder.CreateFolderAsync(winrt::hstring)

Atributos

OverloadAttribute RemoteAsyncAttribute

Excepciones

FileNotFoundException

El nombre de la carpeta contiene caracteres no válidos o el formato del nombre de la carpeta es incorrecto. Compruebe el valor de desiredName.

UnauthorizedAccessException

No tiene permiso para crear una subcarpeta en la carpeta actual.

Ejemplos

En el ejemplo siguiente se muestra cómo crear una nueva storageFolder en la carpeta actual mediante una llamada al método sobrecargado CreateFolderAsync(String, CreationCollisionOption). En este ejemplo se especifica explícitamente un valor para las opciones que hacen que se produzca un error en la operación si ya existe una carpeta con el desiredName especificado en la carpeta actual.

using Windows.Storage;
using System.Threading.Tasks;

// Get the app's local folder.
StorageFolder localFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;

// Create a new subfolder in the current folder.
// Raise an exception if the folder already exists.
string desiredName = "Subfolder";
StorageFolder newFolder =
    await localFolder.CreateFolderAsync(desiredName, CreationCollisionOption.FailIfExists);

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's local folder.
    Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };

    // Create a new subfolder in the current folder.
    // Throw an exception if it already exists.
    std::wstring desiredName{ L"Subfolder" };
    Windows::Storage::StorageFolder folder{ co_await localFolder.CreateFolderAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists) };

    // Do something with folder.
}

//Get app's local folder
StorageFolder^ localFolder = Windows::Storage::ApplicationData::Current->LocalFolder;

// Create a new subfolder in the current folder
// Raise an exception if it already exists
String^ desiredName = "Subfolder";
create_task(localFolder->CreateFolderAsync(desiredName,Windows::Storage::CreationCollisionOption::FailIfExists)).then([](StorageFolder^ folder)
{
   //Do something with folder
});

Comentarios

Este método usa el valor FailIfExists de la enumeración CreationCollisionOption de forma predeterminada. Es decir, este método genera una excepción si ya existe una subcarpeta con el mismo nombre en la carpeta actual. Si desea controlar una colisión de nombres de carpeta de otra manera, llame al método CreateFolderAsync(String, CreationCollisionOption).

Si intenta crear una subcarpeta en una carpeta virtual como una biblioteca o una carpeta que represente un contenedor para un grupo de archivos (por ejemplo, el valor devuelto de algunas sobrecargas del método GetFoldersAsync ), puede producirse un error en el método CreateFolderAsync.

Consulte también

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

Crea una nueva subcarpeta con el nombre especificado en la carpeta actual. Este método también especifica qué hacer si ya existe una subcarpeta con el mismo nombre en la carpeta actual.

public:
 virtual IAsyncOperation<StorageFolder ^> ^ CreateFolderAsync(Platform::String ^ desiredName, CreationCollisionOption options) = CreateFolderAsync;

/// [Windows.Foundation.Metadata.Overload("CreateFolderAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFolder> CreateFolderAsync(winrt::hstring const& desiredName, CreationCollisionOption const& options);

[Windows.Foundation.Metadata.Overload("CreateFolderAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFolder> CreateFolderAsync(string desiredName, CreationCollisionOption options);

function createFolderAsync(desiredName, options)

Public Function CreateFolderAsync (desiredName As String, options As CreationCollisionOption) As IAsyncOperation(Of StorageFolder)

Parámetros

desiredName

String

Platform::String

winrt::hstring

Nombre de la nueva subcarpeta que se va a crear en la carpeta actual.

options

CreationCollisionOption

Uno de los valores de enumeración que determina cómo controlar la colisión si ya existe una subcarpeta con el desiredName especificado en la carpeta actual.

Devoluciones

IAsyncOperation<StorageFolder>

Cuando se completa este método, devuelve una clase StorageFolder que representa la nueva subcarpeta.

Implementaciones

M:Windows.Storage.IStorageFolder.CreateFolderAsync(System.String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFolderAsync(Platform::String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFolderAsync(winrt::hstring,Windows.Storage.CreationCollisionOption)

Atributos

OverloadAttribute RemoteAsyncAttribute

Excepciones

FileNotFoundException

El nombre de la carpeta contiene caracteres no válidos o el formato del nombre de la carpeta es incorrecto. Compruebe el valor de desiredName.

UnauthorizedAccessException

No tiene permiso para crear una subcarpeta en la carpeta actual.

Comentarios

Si ya existe una carpeta con el desiredName especificado en la carpeta actual, creationCollisionOption especificada determina cómo controlar la colisión.

Consulte también

• CreateFolderAsync(String)