FileSystemProxy.RenameFile(String, String) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

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:
 void RenameFile(System::String ^ file, System::String ^ newName);

public void RenameFile (string file, string newName);

member this.RenameFile : string * string -> unit

Public 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 fichier 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	Procédure : renommer un fichier

S’applique à

Partager via