Partager via

Guide pratique pour renommer un fichier en Visual Basic

Dans Visual Basic, il existe deux façons de renommer un fichier. Vous pouvez utiliser l’objet My.Computer.FileSystem d’exécution Visual Basic 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 Move méthode pour « déplacer » le fichier vers le même emplacement, mais avec un autre nom de fichier. Cette méthode peut également être utilisée pour déplacer le fichier vers un autre emplacement avec un nom différent, en effectuant un déplacement et en renommant ensemble.

L’exemple suivant renomme le fichier situé dans le My Documents dossier de TextFile.txt vers 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 l’environnement d'exécution de Visual Basic

Utilisez la RenameFile méthode 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. Cette méthode ne peut pas être utilisée 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 situé dans le My Documents dossier de TextFile.txt vers 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 le système de fichiers : traitement des lecteurs, dossiers et fichiers. Pour plus d’informations, consultez Extraits de code.

Programmation robuste

Les conditions suivantes peuvent entraîner une exception :

  • Le chemin d’accès n’est pas valide pour l’une des raisons suivantes : il s’agit d’une chaîne de longueur nulle, il contient uniquement des espaces blancs, il contient des caractères non valides ou il s’agit d’un chemin d’accès d’appareil (commence par \\.\) (ArgumentException).
  • newName contient des informations de chemin d’accès (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).
  • Il existe un fichier ou un répertoire existant avec le nom spécifié dans newName (IOException).
  • Le chemin dépasse la longueur maximale définie par le système (PathTooLongException).
  • Un nom de fichier ou de répertoire dans le chemin contient un signe deux-points (:) ou est dans un format non valide (NotSupportedException).
  • L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès (SecurityException).
  • L’utilisateur n’a pas l’autorisation requise (UnauthorizedAccessException).

Voir aussi

  • Last updated on