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.
Pour |
Consultez |
---|---|
Renommer un répertoire |
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
Type de projet |
Disponible |
---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Oui |
Application console |
Oui |
Bibliothèque de contrôles Windows |
Oui |
Bibliothèque de contrôles Web |
Oui |
Service Windows |
Oui |
Site Web |
Oui |
Autorisations
L'autorisation suivante peut être nécessaire :
Autorisation |
Description |
---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
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.MoveDirectory, méthode
Autres ressources
Création, suppression et déplacement de fichiers et de répertoires en Visual Basic