FileSystem.Rename, méthode

Article
08/21/2007

Renomme un fichier ou un répertoire sur un disque. La fonctionnalité My permet une meilleure productivité et de meilleures performances dans les opérations d'E/S de fichier que Rename. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Sub Rename ( _
    OldPath As String, _
    NewPath As String _
)
'Utilisation
Dim OldPath As String
Dim NewPath As String

FileSystem.Rename(OldPath, NewPath)

public static void Rename (
    string OldPath,
    string NewPath
)

public:
static void Rename (
    String^ OldPath, 
    String^ NewPath
)

public static void Rename (
    String OldPath, 
    String NewPath
)

public static function Rename (
    OldPath : String, 
    NewPath : String
)

Paramètres

OldPath
Obligatoire. Expression String qui spécifie le nom et l'emplacement du fichier existant. OldPath peut inclure le répertoire et le lecteur du fichier.

NewPath
Obligatoire. expression String qui spécifie le nouveau nom et l'emplacement du 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.

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Rename, fonction.

La fonction Rename renomme un fichier et le déplace au besoin vers un répertoire différent. La fonction Rename peut déplacer un fichier d'un lecteur à un autre, mais elle ne peut renommer qu'un répertoire existant lorsque NewPath et OldPath sont situés sur le même lecteur. Rename ne peut pas créer de nouveau fichier ou répertoire.

La fonction Rename sur un fichier ouvert génère une erreur. Vous devez fermer un fichier ouvert avant de le renommer. Les arguments Rename ne peuvent pas inclure de caractères génériques à plusieurs caractères (*) ou un seul caractère (?).

Remarque de sécurité
Lorsque vous utilisez Rename pour copier un fichier depuis un emplacement non protégé vers un emplacement protégé, le fichier conserve les droits les moins restrictifs. Vérifiez que vous n'introduisez pas de risque éventuel pour la sécurité.

Exemple

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

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)

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

FileSystem, classe
Membres FileSystem
Microsoft.VisualBasic, espace de noms
ArgumentException Class
FileNotFoundException Class
IOException Class

Autres ressources

Rename, fonction
Kill, fonction
Comment : renommer un fichier dans Visual Basic
Comment : renommer un répertoire dans Visual Basic

Partager via