StorageFolder.CreateFolderAsync Methode

Definition

Namespace:

Windows.Storage

Überlädt

CreateFolderAsync(String)	Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner.
CreateFolderAsync(String, CreationCollisionOption)	Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn ein Unterordner mit demselben Namen bereits im aktuellen Ordner vorhanden ist.

CreateFolderAsync(String)

Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner.

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

desiredName

String

Platform::String

winrt::hstring

Der Name des neuen Unterordners, der im aktuellen Ordner erstellt werden soll.

Gibt zurück

IAsyncOperation<StorageFolder>

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

Implementiert

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

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

Der Ordnername enthält ungültige Zeichen, oder das Format des Ordnernamens ist falsch. Überprüfen Sie den Wert von desiredName.

UnauthorizedAccessException

Sie sind nicht berechtigt, einen Unterordner im aktuellen Ordner zu erstellen.

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)

CreateFolderAsync(String, CreationCollisionOption)

Erstellt einen neuen Unterordner mit dem angegebenen Namen im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn ein Unterordner mit demselben Namen bereits im aktuellen Ordner vorhanden ist.

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

desiredName

String

Platform::String

winrt::hstring

Der Name des neuen Unterordners, der im aktuellen Ordner erstellt werden soll.

options

CreationCollisionOption

Einer der Enumerationswerte, der bestimmt, wie die Kollision behandelt werden soll, wenn im aktuellen Ordner bereits ein Unterordner mit dem angegebenen desiredName vorhanden ist.

Gibt zurück

IAsyncOperation<StorageFolder>

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

Implementiert

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)

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

Der Ordnername enthält ungültige Zeichen, oder das Format des Ordnernamens ist falsch. Überprüfen Sie den Wert von desiredName.

UnauthorizedAccessException

Sie sind nicht berechtigt, einen Unterordner im aktuellen Ordner zu erstellen.

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)