DownloadsFolder.CreateFileForUserAsync 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
| CreateFileForUserAsync(User, String) |
Erstellt eine neue Datei im Ordner Downloads eines bestimmten Benutzers. |
| CreateFileForUserAsync(User, String, CreationCollisionOption) |
Erstellt eine neue Datei im Ordner Downloads eines bestimmten Benutzers und gibt an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im Ordner Downloads vorhanden ist. |
CreateFileForUserAsync(User, String)
Erstellt eine neue Datei im Ordner Downloads eines bestimmten Benutzers.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);function createFileForUserAsync(user, desiredName)Public Shared Function CreateFileForUserAsync (user As User, 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
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)
|
Weitere Informationen
Gilt für:
CreateFileForUserAsync(User, String, CreationCollisionOption)
Erstellt eine neue Datei im Ordner Downloads eines bestimmten Benutzers und gibt an, was zu tun ist, wenn eine Datei mit demselben Namen bereits im Ordner Downloads vorhanden ist.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);function createFileForUserAsync(user, desiredName, option)Public Shared Function CreateFileForUserAsync (user As User, 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 des angegebenen Benutzers zugreifen kann, 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
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v2.0)
|