Partager via


FileSystem.Rename(String, String) Méthode

Définition

Renomme un fichier ou un répertoire sur un disque. La fonctionnalité My améliore la productivité et les performances des opérations d’E/S de fichier par rapport à Rename. Pour plus d'informations, consultez FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

Paramètres

OldPath
String

Obligatoire. Une expression de chaîne qui spécifie le nom et l’emplacement du fichier existant. OldPath peut inclure le répertoire et le lecteur du fichier.

NewPath
String

Obligatoire. Une expression de chaîne qui spécifie le nom et l’emplacement du nouveau fichier. NewPath peut inclure le répertoire et le lecteur de l'emplacement de destination. Le nom de fichier spécifié par NewPath ne peut pas déjà exister.

Attributs

Exceptions

Le chemin n’est pas valide.

Le fichier OldPath n'existe pas.

Impossible de renommer vers un autre périphérique.

Exemples

Cet exemple utilise la Rename fonction pour renommer un fichier. Pour les besoins de cet exemple, supposons que les répertoires spécifiés existent déjà.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

Remarques

LaRename fonction renomme un fichier et le déplace vers un autre répertoire, si nécessaire. La Rename fonction peut déplacer un fichier sur plusieurs lecteurs, mais elle ne peut renommer un répertoire existant que lorsque et NewPathOldPath se trouvent sur le même lecteur. Rename impossible de créer un fichier ou un répertoire.

L’utilisation de la Rename fonction sur un fichier ouvert génère une erreur. Vous devez fermer un fichier ouvert avant de le renommer. Rename les arguments ne peuvent pas inclure des caractères génériques à caractères multiples (*) et à caractère unique ( ?).

Important

Lorsque vous utilisez Rename pour copier un fichier d’un emplacement non protégé vers un emplacement protégé, le fichier conserve les droits les moins restreints. Vérifiez que vous n’introduisez pas de risque de sécurité possible.

S’applique à

Voir aussi