StorageFolder.CreateFileAsync 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
| CreateFileAsync(String) |
Erstellt eine neue Datei mit dem angegebenen Namen im aktuellen Ordner. |
| CreateFileAsync(String, CreationCollisionOption) |
Erstellt eine neue Datei im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im aktuellen Ordner vorhanden ist. |
CreateFileAsync(String)
Erstellt eine neue Datei mit dem angegebenen Namen im aktuellen Ordner.
public:
virtual IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName) = CreateFileAsync;/// [Windows.Foundation.Metadata.Overload("CreateFileAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);function createFileAsync(desiredName)Public Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)Parameter
- desiredName
-
String
Platform::String
winrt::hstring
Der Name der neuen Datei, die im aktuellen Ordner erstellt werden soll.
Gibt zurück
Nach Abschluss dieser Methode wird eine StorageFile-Datei zurückgegeben, die die neue Datei darstellt.
Implementiert
- Attribute
Ausnahmen
Der Dateiname enthält ungültige Zeichen, oder das Format des Dateinamens ist falsch. Überprüfen Sie den Wert von desiredName.
Sie haben keine Berechtigung zum Erstellen einer Datei im aktuellen Ordner.
Beispiele
Das folgende Beispiel zeigt, wie Sie eine neue Datei im aktuellen Ordner erstellen, indem Sie die überladene Methode CreateFileAsync (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 eine Datei 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 file in the current folder.
// Raise an exception if the file already exists.
string desiredName = "test.txt";
StorageFile newFile = await localFolder.CreateFileAsync(desiredName, CreationCollisionOption.FailIfExists);
IAsyncAction MainPage::ExampleCoroutineAsync()
{
// Gets the app's local folder.
Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
// Create a new file in the current folder, and throw an exception if the file already exists.
std::wstring desiredName{ L"test.txt" };
StorageFile newFile{ co_await localFolder.CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists) };
// Do something with the new file.
}
//Gets the app's local folder
StorageFolder^ localFolder = ApplicationData::Current->LocalFolder;
//Create a new file in the current folder
// Raise an exception if the file already exists
String^ desiredName = "test.txt";
auto createFileTask = create_task(localFolder->CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists));
createFileTask.then([](StorageFile^ newFile)
{
//Do something with the new file.
});
Hinweise
Diese Methode verwendet standardmäßig den FailIfExists-Wert aus der CreationCollisionOption-Enumeration . Das heißt, diese Methode löst eine Ausnahme aus, wenn eine Datei mit demselben Namen bereits im aktuellen Ordner vorhanden ist. Wenn Sie eine Dateinamenkollision anders behandeln möchten, rufen Sie die CreateFileAsync(String, CreationCollisionOption) -Methode auf.
Wenn Sie versuchen, eine Datei in einem virtuellen Ordner wie einer Bibliothek oder einem Ordner zu erstellen, der einen Container für eine Gruppe von Dateien darstellt (z. B. der Rückgabewert aus einigen Überladungen der GetFoldersAsync-Methode ), schlägt die CreateFileAsync-Methode möglicherweise fehl.
Weitere Informationen
Gilt für:
CreateFileAsync(String, CreationCollisionOption)
Erstellt eine neue Datei im aktuellen Ordner. Diese Methode gibt auch an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im aktuellen Ordner vorhanden ist.
public:
virtual IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption options) = CreateFileAsync;/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& options);[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption options);function createFileAsync(desiredName, options)Public Function CreateFileAsync (desiredName As String, options As CreationCollisionOption) As IAsyncOperation(Of StorageFile)Parameter
- desiredName
-
String
Platform::String
winrt::hstring
Der Name der neuen Datei, die im aktuellen Ordner erstellt werden soll.
- options
- CreationCollisionOption
Einer der Enumerationswerte, der bestimmt, wie die Kollision behandelt werden soll, wenn im aktuellen Ordner bereits eine Datei mit dem angegebenen desiredName vorhanden ist.
Gibt zurück
Nach Abschluss dieser Methode wird eine StorageFile-Datei zurückgegeben, die die neue Datei darstellt.
Implementiert
- Attribute
Ausnahmen
Sie haben CreationCollisionOption.FailIfExists angegeben, und im aktuellen Ordner ist bereits eine Datei mit dem angegebenen desiredName vorhanden.
Das Format des Dateinamens ist falsch. Überprüfen Sie den Wert von desiredName.
Sie haben keine Berechtigung zum Erstellen einer Datei im aktuellen Ordner.