Partager via


File.RenameTo(File) Méthode

Définition

Renomme le fichier indiqué par ce chemin d’accès abstrait.

[Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")]
public virtual bool RenameTo (Java.IO.File dest);
[<Android.Runtime.Register("renameTo", "(Ljava/io/File;)Z", "GetRenameTo_Ljava_io_File_Handler")>]
abstract member RenameTo : Java.IO.File -> bool
override this.RenameTo : Java.IO.File -> bool

Paramètres

dest
File

Nouveau chemin d’accès abstrait pour le fichier nommé

Retours

true si et uniquement si le changement de nom a réussi ; false autrement

Attributs

Remarques

Renomme le fichier indiqué par ce chemin d’accès abstrait.

De nombreux échecs sont possibles. Voici quelques-unes des défaillances les plus probables : <l’autorisation ul><li>Write est requise sur les répertoires contenant les chemins source et de destination. <l’autorisation li>Search est requise pour tous les parents des deux chemins. <li>Les deux chemins se trouver sur le même point de montage. Sur Android, les applications sont susceptibles d’atteindre cette restriction lors de la tentative de copie entre le stockage interne et une carte SD. </ul>

La valeur de retour doit toujours être vérifiée pour vous assurer que l’opération de renommage a réussi.

Notez que la java.nio.file.Files classe définit la java.nio.file.Files#move move méthode pour déplacer ou renommer un fichier de manière indépendante de la plateforme.

Documentation Java pour java.io.File.renameTo(java.io.File).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à