Comment : renommer un répertoire dans Visual Basic

Mise à jour : novembre 2007

Vous pouvez utiliser la méthode RenameDirectory de l'objet My.Computer.FileSystem pour renommer un répertoire en fournissant l'emplacement actuel et le nom du répertoire, ainsi que le nouveau nom du répertoire. Cette méthode ne peut pas être utilisée pour déplacer un répertoire ; utilisez plutôt la méthode MoveDirectory pour déplacer et renommer le répertoire.

Pour renommer un répertoire

  • Utilisez la méthode My.Computer.FileSystem.RenameDirectory pour renommer un répertoire. L'exemple de code suivant remplace le nom du répertoire Test par SecondTest.

    My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", _
    "SecondTest")
    

Cet exemple de code est également disponible sous forme d'extrait de code IntelliSense. Dans le sélecteur d'extrait de code, l'exemple 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 dans votre code (Visual Basic).

Programmation fiable

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

  • Le chemin d'accès n'est pas valide pour 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'accès de périphérique (qui commence 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 répertoire source n'est pas valide ou n'existe pas (DirectoryNotFoundException).

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

  • Le dossier est un dossier racine (IOException).

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

  • Un nom de fichier ou de dossier 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 : copier un répertoire vers un autre répertoire dans Visual Basic

Comment : analyser des chemins d'accès dans Visual Basic

Comment : déplacer un répertoire dans Visual Basic

Comment : déplacer le contenu d'un répertoire dans Visual Basic

Référence

My.Computer.FileSystem.RenameDirectory, méthode