FileSystem.RenameFile(String, String) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 sur le chemin d’accès ou se termine par une barre oblique inverse (\).

ArgumentNullException

file a la valeur Nothing.

- ou -

newName est soit Nothing soit une chaîne vide.

FileNotFoundException

Le répertoire n'existe pas.

IOException

Un fichier ou répertoire existe avec le nom spécifié dans newName.

PathTooLongException

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

NotSupportedException

Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct.

SecurityException

L'utilisateur n'a pas les 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 méthode MoveFile 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

S’applique à