DownloadsFolder.CreateFileForUserAsync Méthode

Définition

Espace de noms:

Windows.Storage

Surcharges

CreateFileForUserAsync(User, String)	Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique.
CreateFileForUserAsync(User, String, CreationCollisionOption)	Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique et spécifie ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier Téléchargements.

CreateFileForUserAsync(User, String)

Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique.

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)

Paramètres

user

User

Utilisateur pour lequel le fichier est créé.

desiredName

String

Platform::String

winrt::hstring

Nom souhaité du fichier à créer.

Si un fichier portant le nom spécifié existe déjà, un nom similaire mais unique est utilisé. Par exemple, si desiredName est « MyFileName.jpg » et qu’un fichier portant ce nom existe déjà dans le dossier Téléchargements, le nouveau fichier est créé avec un nom comme « MyFileName (1).jpg » à la place.

Retours

IAsyncOperation<StorageFile>

Une fois cette méthode terminée, elle retourne le nouveau fichier sous la forme d’un objet StorageFile .

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v2.0)

Voir aussi

• CreateFileForUserAsync(User, String, CreationCollisionOption)
• StorageFile

CreateFileForUserAsync(User, String, CreationCollisionOption)

Crée un fichier dans le dossier Téléchargements d’un utilisateur spécifique et spécifie ce qu’il faut faire si un fichier portant le même nom existe déjà dans le dossier Téléchargements.

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)

Paramètres

user

User

Utilisateur pour lequel le fichier est créé.

desiredName

String

Platform::String

winrt::hstring

Nom souhaité du fichier à créer.

S’il existe un fichier existant dans le dossier actif qui a déjà le desiredName spécifié, l’option CreationCollisionoption spécifiée détermine la façon dont Windows répond au conflit.

option

CreationCollisionOption

Valeur d’énumération qui détermine la façon dont Windows répond si le desiredName est identique au nom d’un fichier existant dans le dossier actif.

Étant donné que l’application ne peut accéder qu’aux fichiers du dossier Téléchargements de l’utilisateur spécifié, vous ne pouvez pas spécifier OpenIfExists ou ReplaceExisting pour ce paramètre.

Retours

IAsyncOperation<StorageFile>

Une fois cette méthode terminée, elle retourne le nouveau fichier sous la forme d’un objet StorageFile .

Attributs

OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v2.0)

Voir aussi

• CreateFileForUserAsync(User, String)
• StorageFile