My.Computer.FileSystem.RenameDirectory, méthode

Mise à jour : novembre 2007

Renomme un répertoire.

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

Paramètres

• directory
  String. Chemin d'accès et nom du répertoire à renommer. Obligatoire.

• newName
  String. Nouveau nom du répertoire. Obligatoire.

Exceptions

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).

• Le paramètre 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).

• Le paramètre 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).

• Il existe un fichier ou un répertoire portant le nom spécifié dans newName (IOException).

• Le répertoire est un répertoire racine (IOException).

• Le chemin d'accès dépasse 248 caractères (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).

Notes

Cette méthode ne peut pas être utilisée pour déplacer un répertoire ; utilisez la méthode MoveDirectory pour déplacer et renommer le répertoire.

Tâches

Le tableau suivant présente un exemple de tâche impliquant la méthode My.Computer.FileSystem.RenameDirectory.

Exemple

Cet exemple renomme le répertoire Test en SecondTest.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

L'autorisation suivante peut être nécessaire :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

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

Référence

My.Computer.FileSystem, objet

RenameDirectory

My.Computer.FileSystem.MoveDirectory, méthode

Autres ressources

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