StorageFolder.CreateFolderAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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
Nach Abschluss dieser Methode wird ein StorageFolder zurückgegeben, der den neuen Unterordner darstellt.
Implementiert
- Attribute
Ausnahmen
Der Ordnername enthält ungültige Zeichen, oder das Format des Ordnernamens ist falsch. Überprüfen Sie den Wert von desiredName.
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
Gilt für:
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
Nach Abschluss dieser Methode wird ein StorageFolder zurückgegeben, der den neuen Unterordner darstellt.
Implementiert
- Attribute
Ausnahmen
Der Ordnername enthält ungültige Zeichen, oder das Format des Ordnernamens ist falsch. Überprüfen Sie den Wert von desiredName.
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.