DownloadsFolder.CreateFileForUserAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Une fois cette méthode terminée, elle retourne le nouveau fichier sous la forme d’un objet StorageFile .
- Attributs
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
S’applique à
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
Une fois cette méthode terminée, elle retourne le nouveau fichier sous la forme d’un objet StorageFile .
- Attributs
Configuration requise pour Windows
| Famille d’appareils |
Windows 10 (introduit dans 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduit dans v2.0)
|