StorageFolder.DeleteAsync メソッド

定義

名前空間:

Windows.Storage

オーバーロード

DeleteAsync()	現在のフォルダーを削除します。
DeleteAsync(StorageDeleteOption)	現在のフォルダーを削除します。 このメソッドは、フォルダーを完全に削除するかどうかを指定します。

DeleteAsync()

現在のフォルダーを削除します。

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

戻り値

IAsyncAction

このメソッドが完了すると、オブジェクトまたは値は返されません。

実装

DeleteAsync()

属性

OverloadAttribute RemoteAsyncAttribute

例外

UnauthorizedAccessException

指定したフォルダーを削除する権限がありません。

例

次の例では、 DeleteAsync(StorageDeleteOption) オーバーロードされたメソッドを呼び出して、現在のフォルダーを削除する方法を示します。 この例では、ファイルを完全に削除する オプション の値を明示的に指定します。

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

注釈

このメソッドは、 StorageDeleteOption.Default を暗黙的に使用して、アイテムが完全に削除されるかどうかを判断します。

こちらもご覧ください

• DeleteAsync(StorageDeleteOption)

DeleteAsync(StorageDeleteOption)

現在のフォルダーを削除します。 このメソッドは、フォルダーを完全に削除するかどうかを指定します。

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

パラメーター

option

StorageDeleteOption

フォルダーを完全に削除するかどうかを指定する列挙値の 1 つ。

戻り値

IAsyncAction

このメソッドが完了すると、オブジェクトまたは値は返されません。

実装

DeleteAsync(StorageDeleteOption)

属性

OverloadAttribute RemoteAsyncAttribute

例外

UnauthorizedAccessException

指定したフォルダーを削除する権限がありません。

こちらもご覧ください

• DeleteAsync()