My.Computer.FileSystem.RenameFile, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Renomme un fichier.

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

Paramètres

file
String. Fichier à renommer. Obligatoire.
newName
String. Nouveau nom de fichier. 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 ou se termine par une barre oblique inverse (\) (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 fichier source n'est pas valide ou n'existe pas (FileNotFoundException).
Il existe un fichier ou un répertoire portant le nom spécifié dans newName (IOException).
Le chemin d'accès dépasse la longueur maximale définie par le système (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 fichier ; utilisez la méthode My.Computer.FileSystem.MoveFile pour déplacer et renommer le fichier.

Tâches

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

Pour	Consultez
Renommer un fichier	Comment : renommer un fichier dans Visual Basic

Exemple

Cet exemple renomme le fichier Test.txt dans SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Remplacez "C:\Test.txt" par le chemin d'accès et le nom du fichier que vous souhaitez renommer.

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