FileSystem.RenameFile(String, String) Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.dll

Renomme un fichier.

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile(string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

Paramètres

file

String

Fichier à renommer.

newName

String

Nouveau nom du fichier.

Exceptions

ArgumentException

newName contient des informations de chemin d’accès ou se termine par une barre oblique inverse (\).

ArgumentNullException

file a la valeur Nothing.

-ou-

newName est Nothing ou une chaîne vide.

FileNotFoundException

Le répertoire n’existe pas.

IOException

Il existe un fichier ou un répertoire existant avec le nom spécifié dans newName.

PathTooLongException

Le chemin dépasse la longueur maximale définie par le système.

NotSupportedException

Un nom de fichier ou de répertoire dans le chemin contient un signe deux-points (:) ou est dans un format non valide.

SecurityException

L’utilisateur ne dispose pas des autorisations nécessaires pour afficher le chemin d’accès.

UnauthorizedAccessException

L’utilisateur n’a pas l’autorisation requise.

Exemples

Cet exemple renomme le fichier Test.txt en 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.

Remarques

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

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

À	Consultez
Renommer un fichier	Guide pratique pour renommer un fichier en Visual Basic