Partager via


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

Comment : renommer un répertoire dans Visual Basic

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

FileIOPermission

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, 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