DownloadsFolder.CreateFileForUserAsync Methode

Definition

Namespace:

Windows.Storage

Ü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

user

User

Der Benutzer , für den die Datei erstellt wird.

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

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

• CreateFileForUserAsync(User, String, CreationCollisionOption)
• StorageFile

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

user

User

Der Benutzer , für den die Datei erstellt wird.

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

IAsyncOperation<StorageFile>

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

Attribute

OverloadAttribute RemoteAsyncAttribute

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

• CreateFileForUserAsync(User, String)
• StorageFile