StorageFolder.CreateFolderAsync Methode

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)

Parameter

Gibt zurück

Nach Abschluss dieser Methode wird ein StorageFolder zurückgegeben, der den neuen Unterordner darstellt.

Implementiert

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

Beispiele

Das folgende Beispiel zeigt, wie Sie einen neuen StorageFolder im aktuellen Ordner erstellen, indem Sie die überladene Methode CreateFolderAsync(String, CreationCollisionOption) aufrufen. In diesem Beispiel wird explizit ein Wert für Optionen angegeben, der dazu führt, dass der Vorgang fehlschlägt, wenn im aktuellen Ordner bereits ein Ordner mit dem angegebenen desiredName vorhanden ist.

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

Hinweise

Diese Methode verwendet standardmäßig den FailIfExists-Wert aus der CreationCollisionOption-Enumeration . Das heißt, diese Methode löst eine Ausnahme aus, wenn ein Unterordner mit demselben Namen bereits im aktuellen Ordner vorhanden ist. Wenn Sie eine Ordnernamenkollision auf andere Weise behandeln möchten, rufen Sie die CreateFolderAsync(String, CreationCollisionOption)- Methode auf.

Wenn Sie versuchen, einen Unterordner in einem virtuellen Ordner wie einer Bibliothek oder einen Ordner zu erstellen, der einen Container für eine Gruppe von Dateien darstellt (z. B. der Rückgabewert von einigen Überladungen der GetFoldersAsync-Methode ), schlägt die CreateFolderAsync-Methode möglicherweise fehl.

Weitere Informationen

• 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)

Parameter

Gibt zurück

Nach Abschluss dieser Methode wird ein StorageFolder zurückgegeben, der den neuen Unterordner darstellt.

Implementiert

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

Hinweise

Wenn im aktuellen Ordner bereits ein Ordner mit dem angegebenen desiredName vorhanden ist, bestimmt die angegebene CreationCollisionOption , wie die Kollision behandelt werden soll.

Weitere Informationen

• CreateFolderAsync(String)