StorageFolder.CreateFileAsync Methode

Definition

Namespace:

Windows.Storage

Ü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

IAsyncOperation<StorageFile>

Nach Abschluss dieser Methode wird eine StorageFile-Datei zurückgegeben, die die neue Datei darstellt.

Implementiert

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

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

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

UnauthorizedAccessException

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

• CreateFileAsync(String, CreationCollisionOption)

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

IAsyncOperation<StorageFile>

Nach Abschluss dieser Methode wird eine StorageFile-Datei zurückgegeben, die die neue Datei darstellt.

Implementiert

M:Windows.Storage.IStorageFolder.CreateFileAsync(System.String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFileAsync(Platform::String,Windows.Storage.CreationCollisionOption) M:Windows.Storage.IStorageFolder.CreateFileAsync(winrt::hstring,Windows.Storage.CreationCollisionOption)

Attribute

OverloadAttribute RemoteAsyncAttribute

Ausnahmen

Exception

Sie haben CreationCollisionOption.FailIfExists angegeben, und im aktuellen Ordner ist bereits eine Datei mit dem angegebenen desiredName vorhanden.

FileNotFoundException

Das Format des Dateinamens ist falsch. Überprüfen Sie den Wert von desiredName.

UnauthorizedAccessException

Sie haben keine Berechtigung zum Erstellen einer Datei im aktuellen Ordner.

Weitere Informationen

• CreateFileAsync(String)