FileSystem.Rename(String, String) Méthode
Définition
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 ou un répertoire de disque. La My fonctionnalité vous offre une meilleure productivité et des performances dans les opérations d’E/S de fichier que 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 -> unitstatic member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Paramètres
- OldPath
- String
Obligatoire. Expression de chaîne qui spécifie le nom et l’emplacement de fichier existants.
OldPath peut inclure le répertoire et le lecteur du fichier.
- NewPath
- String
Obligatoire. Expression de chaîne qui spécifie le nouveau nom de fichier et l’emplacement.
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 d’accès n’est pas valide.
OldPath le fichier n’existe pas.
Impossible de renommer un autre appareil.
Exemples
Cet exemple utilise la Rename fonction pour renommer un fichier. À des fins 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, s’il est nécessaire. La Rename fonction peut déplacer un fichier sur plusieurs lecteurs, mais il ne peut renommer qu’un répertoire existant lorsque les deux NewPath et OldPath 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 moins restreints. Vérifiez que vous n’introduisez pas de risque de sécurité possible.
