DownloadsFolder.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) Method

Erstellt eine neue Datei im Ordner "Downloads" und gibt an, welcher Schritt erforderlich ist, wenn im Ordner "Downloads" bereits eine Datei mit demselben Namen vorhanden ist.

Syntax


Windows.Storage.DownloadsFolder.createFileAsync(desiredName, option).done( /* Ihre Erfolgs -und Fehlerhandler */ );

Parameter

desiredName

Typ: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Der gewünschte Name der zu erstellenden Datei.

Wenn eine vorhandene Datei im aktuellen Ordner bereits den angegebenen desiredName besitzt, bestimmt die angegebene CreationCollisionOption, wie Windows auf den Konflikt reagiert.

option

Typ: CreationCollisionOption

Der Enum-Wert, der bestimmt, wie Windows reagiert, wenn desiredName mit dem Namen einer vorhandenen Datei im aktuellen Ordner identisch ist.

Da die App nur auf Dateien in dem Downloadordner zugreifen kann, den sie erstellt hat, können Sie OpenIfExists oder ReplaceExisting für diesen Parameter nicht angeben.

Rückgabewert

Typ: IAsyncOperation<StorageFile>

Wenn diese Methode abgeschlossen ist, wird die neue Datei als StorageFile-Objekt zurückgegeben.

Anmerkungen

Alle Apps verfügen automatisch über die Berechtigung, Dateien im Downloadordner zu erstellen. Es ist keine Funktion erforderlich. Weitere Informationen über diese Funktionen finden Sie unter Zugriff auf Benutzerressourcen mit Windows-Runtime.

Beispiele

Sie können eine leere Datei im Downloadordner wie folgt erstellen:


Windows.Storage.DownloadsFolder.createFileAsync("sample.txt").done(function (file) {
        // Your code
    });

Schreiben Sie in die leere Datei nach ihrer Erstellung, indem Sie then oder done verwenden, um eine Funktion zu deklarieren, die file als StorageFile-Objekt erfasst (siehe Beispiel).

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8

Unterstützte Mindestversion (Server)

Windows Server 2012

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

Weitere Informationen

DownloadsFolder
CreateFileAsync(String)

 

 

Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.