StorageFolder.CreateFolderAsync Método

Definição

Namespace:

Windows.Storage

Sobrecargas

CreateFolderAsync(String)	Cria uma nova subpasta com o nome especificado na pasta atual.
CreateFolderAsync(String, CreationCollisionOption)	Cria uma nova subpasta com o nome especificado na pasta atual. Esse método também especifica o que fazer se uma subpasta com o mesmo nome já existir na pasta atual.

CreateFolderAsync(String)

Cria uma nova subpasta com o nome especificado na pasta atual.

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

O nome da nova subpasta a ser criada na pasta atual.

Retornos

IAsyncOperation<StorageFolder>

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

Implementações

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

Atributos

OverloadAttribute RemoteAsyncAttribute

Exceções

FileNotFoundException

O nome da pasta contém caracteres inválidos ou o formato do nome da pasta está incorreto. Verifique o valor de desiredName.

UnauthorizedAccessException

Você não tem permissão para criar uma subpasta na pasta atual.

Exemplos

O exemplo a seguir mostra como criar um novo StorageFolder na pasta atual chamando o método sobrecarregado CreateFolderAsync(String, CreationCollisionOption ). Este exemplo especifica explicitamente um valor para opções que fazem com que a operação falhe se uma pasta com o desiredName especificado já existir na pasta atual.

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
});

Comentários

Esse método usa o valor FailIfExists da enumeração CreationCollisionOption por padrão. Ou seja, esse método gerará uma exceção se uma subpasta com o mesmo nome já existir na pasta atual. Se você quiser lidar com uma colisão de nome de pasta de uma maneira diferente, chame o método CreateFolderAsync(String, CreationCollisionOption).

Se você tentar criar uma subpasta em uma pasta virtual como uma biblioteca ou uma pasta que representa um contêiner para um grupo de arquivos (por exemplo, o valor retornado de algumas sobrecargas do método GetFoldersAsync ), o método CreateFolderAsync poderá falhar.

Confira também

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

Cria uma nova subpasta com o nome especificado na pasta atual. Esse método também especifica o que fazer se uma subpasta com o mesmo nome já existir na pasta atual.

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

O nome da nova subpasta a ser criada na pasta atual.

options

CreationCollisionOption

Um dos valores de enumeração que determina como lidar com a colisão se uma subpasta com o desiredName especificado já existir na pasta atual.

Retornos

IAsyncOperation<StorageFolder>

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

Implementações

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

Exceções

FileNotFoundException

O nome da pasta contém caracteres inválidos ou o formato do nome da pasta está incorreto. Verifique o valor de desiredName.

UnauthorizedAccessException

Você não tem permissão para criar uma subpasta na pasta atual.

Comentários

Se uma pasta com o desiredName especificado já existir na pasta atual, o CreationCollisionOption especificado determinará como lidar com a colisão.

Confira também

• CreateFolderAsync(String)