Rename, fonction

Article
09/12/2008

Mise à jour : novembre 2007

Renomme un fichier sur disque ou un répertoire.

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

Public Sub Rename( _
   ByVal OldPath As String, _
   ByVal NewPath As String _
)

Paramètres

OldPath
Requis. 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
Requis. Expression String qui spécifie le nouveau nom et le nouvel 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.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Le chemin d'accès n'est pas valide.
FileNotFoundException	53	Le fichier OldPath n'existe pas.
IOException	58	Le fichier NewPath existe déjà.
IOException	75	L'accès est non valide.
IOException	74	Impossible de renommer vers un autre périphérique.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La fonction Rename renomme un fichier et le déplace vers un répertoire différent, si nécessaire. La fonction Rename peut déplacer un fichier dans des lecteurs, mais il peut uniquement renommer un répertoire existant lorsqu'à la fois NewPath et OldPath se trouvent sur le même lecteur. Rename ne peut pas créer de nouveau fichier ou répertoire.

L'utilisation de 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 (?).

Note de sécurité :
Lors de l'utilisation de Rename pour copier un fichier d'un emplacement non protégé vers un emplacement protégé, le fichier conserve les droits moins restreints. Assurez-vous que vous n'introduisez pas d'éventuel risque de sécurité.

Exemple

Cet exemple utilise la fonction Rename pour renommer un fichier. Pour 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)