Comment : renommer un fichier dans Visual Basic

  • Article

Utilisez la méthode RenameFile de l'objet My.Computer.FileSystem pour renommer un fichier en fournissant l'emplacement actuel, le nom de fichier et le nouveau nom de fichier. Cette méthode ne peut pas être utilisée pour déplacer un fichier ; utilisez plutôt la méthode MoveFile pour déplacer et renommer le fichier.

Pour renommer un fichier

  • Utilisez la méthode My.Computer.FileSystem.RenameFile pour renommer un fichier. Cet exemple renomme le fichier Test.txt dans SecondTest.txt.

    ' Change "c:\test.txt" to the path and filename for the file that
' you want to rename.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Cet exemple de code est également disponible sous forme d'extrait de code IntelliSense. Dans le sélecteur d'extrait de code, l'extrait est localisé dans Système de fichiers - Traitement de lecteurs, de dossiers et de fichiers. Pour plus d'informations, consultez Comment : insérer des extraits de code IntelliSense.

Programmation fiable

Les conditions ci-dessous peuvent générer une exception.

  • Le chemin d'accès est valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle, ne contient que des espaces blancs ; il contient des caractères non valides ou il s'agit d'un chemin d'accès de périphérique (commençant par \ \. \) (ArgumentException).

  • newName contient des informations relatives au chemin d'accès (ArgumentException).

  • Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).

  • newName a la valeur Nothing ou est une chaîne vide (ArgumentNullException).

  • Le fichier source n'est pas valide ou n'existe pas (FileNotFoundException).

  • Un fichier ou répertoire existe avec le nom spécifié dans newName (IOException).

  • Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).

  • Un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).

  • L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).

  • L'utilisateur n'a pas l'autorisation requise (UnauthorizedAccessException).

Voir aussi

Tâches

Comment : déplacer un fichier dans Visual Basic

Comment : déplacer une collection de fichiers dans Visual Basic

Comment : créer une copie d'un fichier dans le même répertoire dans Visual Basic

Comment : créer une copie d'un fichier dans un autre répertoire dans Visual Basic

Référence

RenameFile

Autres ressources

Création, suppression et déplacement de fichiers et de répertoires en Visual Basic