Partage via

Guide pratique pour renommer un fichier en Visual Basic

  • Article

En Visual Basic, il existe deux façons de renommer un fichier. Vous pouvez utiliser l’objet d’exécution Visual Basic My.Computer.FileSystem ou l’objet .NET fourni System.IO.File pour renommer un fichier.

Renommer avec .NET

L’objet System.IO.File ne contient pas de méthode pour renommer un fichier, à la place, utilisez la méthode Move pour « déplacer » le fichier vers le même emplacement, mais avec un autre nom de fichier. Vous pouvez également utiliser cette méthode pour déplacer le fichier vers un autre emplacement avec un nom différent, en effectuant un déplacement et en renommant.

L’exemple suivant renomme le fichier TextFile.txt situé dans le dossier My Documents en NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Renommer avec le runtime de Visual Basic

Utilisez la méthode RenameFile de l’objet My.Computer.FileSystem pour renommer un fichier en fournissant le chemin d’accès complet au fichier et le nouveau nom de fichier. Vous ne pouvez pas utiliser cette méthode pour déplacer un fichier vers un autre répertoire. Pour savoir comment déplacer un fichier, consultez Guide pratique pour déplacer un fichier en Visual Basic.

L’exemple suivant renomme le fichier TextFile.txt situé dans le dossier My Documents en NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

Visual Studio fournit un extrait de code IntelliSense qui utilise My.Computer.FileSystem.RenameFile. L’extrait de code se trouve dans Système de fichiers – Traitement des lecteurs, dossiers et fichiers. Pour plus d’informations, consultez Extraits de code.

Programmation fiable

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

  • Le chemin n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle, il ne contient que des espaces blancs, il contient des caractères non valides ou il s’agit d’un chemin d’appareil (qui commence par \\.\) (ArgumentException).
  • newName contient des informations de chemin (ArgumentException).
  • Le chemin d’accès n’est pas valide, car il est Nothing (ArgumentNullException).
  • newName est Nothing ou une chaîne vide (ArgumentNullException).
  • Le fichier source n’est pas valide ou n’existe pas (FileNotFoundException).
  • Un fichier ou un répertoire porte déjà 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 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 (SecurityException).
  • L’utilisateur n’a pas l’autorisation requise (UnauthorizedAccessException).

Voir aussi