StorageFolder.CreateFolderAsync メソッド

定義

名前空間:

Windows.Storage

オーバーロード

CreateFolderAsync(String)	現在のフォルダーに指定した名前の新しいサブフォルダーを作成します。
CreateFolderAsync(String, CreationCollisionOption)	現在のフォルダーに指定した名前の新しいサブフォルダーを作成します。 このメソッドは、同じ名前のサブフォルダーが現在のフォルダーに既に存在する場合の対処方法も指定します。

CreateFolderAsync(String)

現在のフォルダーに指定した名前の新しいサブフォルダーを作成します。

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)

パラメーター

desiredName

String

Platform::String

winrt::hstring

現在のフォルダーに作成する新しいサブフォルダーの名前。

戻り値

IAsyncOperation<StorageFolder>

このメソッドが完了すると、新しいサブフォルダーを表す StorageFolder が返されます。

実装

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

属性

OverloadAttribute RemoteAsyncAttribute

例外

FileNotFoundException

フォルダー名に無効な文字が含まれているか、フォルダー名の形式が正しくありません。 desiredName の値を確認します。

UnauthorizedAccessException

現在のフォルダーにサブフォルダーを作成する権限がありません。

例

次の例では、CreateFolderAsync(String, CreationCollisionOption) オーバーロードメソッドを呼び出して、現在のフォルダーに新しい StorageFolder を作成する方法を示します。 この例では、指定した desiredName を持つフォルダーが現在のフォルダーに既に存在する場合に、操作が失敗する原因となるオプションの値を明示的に指定します。

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

注釈

このメソッドは、既定で CreationCollisionOption 列挙体の FailIfExists 値を使用します。 つまり、現在のフォルダーに同じ名前のサブフォルダーが既に存在する場合、このメソッドは例外を発生させます。 フォルダー名の競合を別の方法で処理する場合は、 CreateFolderAsync(String, CreationCollisionOption) メソッドを 呼び出します。

ライブラリなどの仮想フォルダー、またはファイルのグループのコンテナーを表すフォルダー ( たとえば、GetFoldersAsync メソッドのいくつかのオーバーロードからの戻り値) にサブフォルダーを作成しようとすると、CreateFolderAsync メソッドが失敗する可能性があります。

こちらもご覧ください

• CreateFolderAsync(String, CreationCollisionOption)

CreateFolderAsync(String, CreationCollisionOption)

現在のフォルダーに指定した名前の新しいサブフォルダーを作成します。 このメソッドは、同じ名前のサブフォルダーが現在のフォルダーに既に存在する場合の対処方法も指定します。

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)

パラメーター

desiredName

String

Platform::String

winrt::hstring

現在のフォルダーに作成する新しいサブフォルダーの名前。

options

CreationCollisionOption

指定した desiredName を持つサブフォルダーが現在のフォルダーに既に存在する場合の競合の処理方法を決定する列挙値の 1 つ。

戻り値

IAsyncOperation<StorageFolder>

このメソッドが完了すると、新しいサブフォルダーを表す StorageFolder が返されます。

実装

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)

属性

OverloadAttribute RemoteAsyncAttribute

例外

FileNotFoundException

フォルダー名に無効な文字が含まれているか、フォルダー名の形式が正しくありません。 desiredName の値を確認します。

UnauthorizedAccessException

現在のフォルダーにサブフォルダーを作成する権限がありません。

注釈

指定した desiredName を持つフォルダーが現在のフォルダーに既に存在する場合、指定した CreationCollisionOption によって競合の処理方法が決まります。

こちらもご覧ください

• CreateFolderAsync(String)