DownloadsFolder.CreateFileAsync Methode

Definition

Namespace:

Windows.Storage

Überlädt

CreateFileAsync(String)	Erstellt eine neue Datei im Ordner Downloads.
CreateFileAsync(String, CreationCollisionOption)	Erstellt eine neue Datei im Ordner Downloads und gibt an, was zu tun ist, wenn im Ordner Downloads bereits eine Datei mit demselben Namen vorhanden ist.

CreateFileAsync(String)

Erstellt eine neue Datei im Ordner Downloads.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName);

/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);

[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);

function createFileAsync(desiredName)

Public Shared Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)

Parameter

desiredName

String

Platform::String

winrt::hstring

Der gewünschte Name der zu erstellenden Datei.

Wenn bereits eine Datei mit dem angegebenen Namen vorhanden ist, wird ein ähnlicher, aber eindeutiger Name verwendet. Wenn desiredName beispielsweise "MyFileName.jpg" ist und eine Datei mit diesem Namen bereits im Ordner Downloads vorhanden ist, wird die neue Datei stattdessen mit einem Namen wie "MyFileName (1).jpg" erstellt.

Gibt zurück

IAsyncOperation<StorageFile>

Nach Abschluss dieser Methode wird die neue Datei als StorageFile-Objekt zurückgegeben.

Attribute

OverloadAttribute RemoteAsyncAttribute

Weitere Informationen

• CreateFileAsync(String, CreationCollisionOption)

CreateFileAsync(String, CreationCollisionOption)

Erstellt eine neue Datei im Ordner Downloads und gibt an, was zu tun ist, wenn im Ordner Downloads bereits eine Datei mit demselben Namen vorhanden ist.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption option);

/// [Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& option);

[Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption option);

function createFileAsync(desiredName, option)

Public Shared Function CreateFileAsync (desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)

Parameter

desiredName

String

Platform::String

winrt::hstring

Der gewünschte Name der zu erstellenden Datei.

Wenn im aktuellen Ordner eine Datei vorhanden ist, die bereits über den angegebenen desiredName verfügt, bestimmt die angegebene CreationCollisionOption , wie Windows auf den Konflikt reagiert.

option

CreationCollisionOption

Der Enumerationswert, der bestimmt, wie Windows reagiert, wenn desiredName mit dem Namen einer vorhandenen Datei im aktuellen Ordner übereinstimmt.

Da die App nur auf Dateien im Ordner Downloads zugreifen kann, den sie erstellt hat, können Sie openIfExists oder ReplaceExisting für diesen Parameter nicht angeben.

Gibt zurück

IAsyncOperation<StorageFile>

Nach Abschluss dieser Methode wird die neue Datei als StorageFile-Objekt zurückgegeben.

Attribute

OverloadAttribute RemoteAsyncAttribute

Weitere Informationen

• CreateFileAsync(String)