DownloadsFolder.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 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
Nach Abschluss dieser Methode wird die neue Datei als StorageFile-Objekt zurückgegeben.
- Attribute
Weitere Informationen
Gilt für:
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
Nach Abschluss dieser Methode wird die neue Datei als StorageFile-Objekt zurückgegeben.
- Attribute