Exporter (0) Imprimer
Développer tout
Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

StorageFile.RenameAsync(String) | renameAsync(String) Method

Renomme le fichier actif.

Syntaxe


storageFile.renameAsync(desiredName).done( /* Vos balises d’erreur et de réussite */ );

Paramètres

desiredName

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Nouveau nom souhaité de l'élément actif.

Valeur de retour

Type: IAsyncAction

Aucun objet ou valeur n'est retourné par cette méthode lorsqu'elle est exécutée.

Remarques

Si le nom que vous spécifiez est non valide, cette méthode lève une exception. Pour gérer tous les types d'invalidité du nom spécifié, vous devez intercepter ces quatre exceptions :

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

 

Si le fichier est supprimé avant l'attribution d'un nouveau nom, cette méthode lève l'exception ERROR_FILE_NOT_FOUND. Vous devez également intercepter et gérer cette exception lorsque vous utilisez cette méthode.

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.Storage
Windows::Storage [C++]

Métadonnées

Windows.winmd

Voir aussi

StorageFile
RenameAsync(String, NameCollisionOption)

 

 

Afficher:
© 2015 Microsoft