StorageFolder.DeleteAsync Método

Definição

Namespace:

Windows.Storage

Sobrecargas

DeleteAsync()	Exclui a pasta atual.
DeleteAsync(StorageDeleteOption)	Exclui a pasta atual. Esse método também especifica se a pasta deve ser excluída permanentemente.

DeleteAsync()

Exclui a pasta atual.

public:
 virtual IAsyncAction ^ DeleteAsync() = DeleteAsync;

/// [Windows.Foundation.Metadata.Overload("DeleteAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction DeleteAsync();

[Windows.Foundation.Metadata.Overload("DeleteAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction DeleteAsync();

function deleteAsync()

Public Function DeleteAsync () As IAsyncAction

Retornos

IAsyncAction

Nenhum objeto ou valor é retornado por esse método quando ele é concluído.

Implementações

DeleteAsync()

Atributos

OverloadAttribute RemoteAsyncAttribute

Exceções

UnauthorizedAccessException

Você não tem permissão para excluir a pasta especificada.

Exemplos

O exemplo a seguir mostra como excluir a pasta atual chamando o método sobrecarregado DeleteAsync(StorageDeleteOption ). Este exemplo especifica explicitamente um valor para a opção que exclui o arquivo permanentemente.

using Windows.Storage;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.

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

// Create a temporary folder in the current folder.
string folderName = "Test";
StorageFolder testFolder = await localFolder.CreateFolderAsync(folderName);

// Has the folder been created?
if(await localFolder.TryGetItemAsync(folderName) != null)
    Debug.WriteLine("Folder " + folderName + " exists.");
else
    Debug.WriteLine("Folder " + folderName + " does not exist.");

// Delete the folder permanently.
await testFolder.DeleteAsync(StorageDeleteOption.PermanentDelete);

// Has the folder been deleted?
if(await localFolder.TryGetItemAsync(folderName) != null)
    Debug.WriteLine("Folder " + folderName + " exists.");
else
    Debug.WriteLine("Folder " + folderName + " does not exist.");

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };

    std::wstring folderName{ L"test" };

    Windows::Storage::StorageFolder newFolder{ co_await localFolder.CreateFolderAsync(folderName) };

    {
        // Check that the folder exists.
        Windows::Storage::IStorageItem newItem{ co_await localFolder.TryGetItemAsync(folderName) };
        std::wstringstream stringstream;
        stringstream << L"Folder: " << folderName.c_str();
        if (newItem)
        {
            stringstream << L" created" << std::endl;
        }
        else
        {
            stringstream << L" not found" << std::endl;
        }
        ::OutputDebugString(stringstream.str().c_str());
    }

    co_await newFolder.DeleteAsync(Windows::Storage::StorageDeleteOption::PermanentDelete);

    {
        // Check that the folder has been deleted.
        Windows::Storage::IStorageItem newItem{ co_await localFolder.TryGetItemAsync(folderName) };
        std::wstringstream stringstream;
        stringstream << L"Folder: " << folderName.c_str();
        if (newItem)
        {
            stringstream << L" not deleted" << std::endl;
        }
        else
        {
            stringstream << L" deleted" << std::endl;
        }
        ::OutputDebugString(stringstream.str().c_str());
    }
}

StorageFolder^ localFolder = ApplicationData::Current->LocalFolder;

String^ folderName = "test";

create_task(localFolder->CreateFolderAsync(folderName)).then([=](StorageFolder^ newFolder) -> task<IStorageItem^> {
    //Check the folder exists
    return create_task(localFolder->TryGetItemAsync(folderName));
}).then([=](IStorageItem^ newFolder) -> task<void> {
    String^ output = "";
    if (newFolder == nullptr)
    {
        output = "Folder: " + folderName + " not found\n";
    }
    else
    {
        output = "Folder: " + folderName + " created\n";
    }
    OutputDebugString(output->Begin());
    return create_task(newFolder->DeleteAsync(StorageDeleteOption::PermanentDelete));
}).then([=]() -> task<IStorageItem^> {
    return create_task(localFolder->TryGetItemAsync(folderName));
}).then([=](IStorageItem^ newFolder) {
    String^ output = "";
    if (newFolder == nullptr)
    {
        output = "Folder: " + folderName + " deleted\n";
    }
    else
    {
        output = "Folder: " + folderName + " not deleted\n";
    }
    OutputDebugString(output->Begin());
});

Comentários

Esse método usa implicitamente StorageDeleteOption.Default para determinar se o item é excluído permanentemente.

Confira também

• DeleteAsync(StorageDeleteOption)

DeleteAsync(StorageDeleteOption)

Exclui a pasta atual. Esse método também especifica se a pasta deve ser excluída permanentemente.

public:
 virtual IAsyncAction ^ DeleteAsync(StorageDeleteOption option) = DeleteAsync;

/// [Windows.Foundation.Metadata.Overload("DeleteAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction DeleteAsync(StorageDeleteOption const& option);

[Windows.Foundation.Metadata.Overload("DeleteAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction DeleteAsync(StorageDeleteOption option);

function deleteAsync(option)

Public Function DeleteAsync (option As StorageDeleteOption) As IAsyncAction

Parâmetros

option

StorageDeleteOption

Um dos valores de enumeração que especifica se a pasta deve ser excluída permanentemente.

Retornos

IAsyncAction

Nenhum objeto ou valor é retornado por esse método quando ele é concluído.

Implementações

DeleteAsync(StorageDeleteOption)

Atributos

OverloadAttribute RemoteAsyncAttribute

Exceções

UnauthorizedAccessException

Você não tem permissão para excluir a pasta especificada.

Confira também

• DeleteAsync()