FileSystem.Rename(String, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wijzigt de naam van een schijfbestand of map. De My functie biedt u betere productiviteit en prestaties in bestands-I/O-bewerkingen dan Rename. Zie FileSystem voor meer informatie.
public:
static void Rename(System::String ^ OldPath, System::String ^ NewPath);public static void Rename(string OldPath, string NewPath);static member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parameters
- OldPath
- String
Required. Een tekenreeksexpressie die de bestaande bestandsnaam en locatie aangeeft.
OldPath kan de map en het station van het bestand bevatten.
- NewPath
- String
Required. Een tekenreeksexpressie die de nieuwe bestandsnaam en locatie aangeeft.
NewPath kan de map en het station van de doellocatie bevatten. De bestandsnaam die is opgegeven door NewPath kan niet al bestaan.
Uitzonderingen
Het pad is ongeldig.
OldPath het bestand bestaat niet.
Kan de naam van het apparaat niet wijzigen.
Voorbeelden
In dit voorbeeld wordt de functie gebruikt om de Rename naam van een bestand te wijzigen. In dit voorbeeld wordt ervan uitgegaan dat de opgegeven mappen al bestaan.
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)
Opmerkingen
DeRename functie wijzigt de naam van een bestand en verplaatst het naar een andere map, indien nodig. De Rename functie kan een bestand verplaatsen tussen stations, maar het kan alleen de naam van een bestaande map wijzigen wanneer beide NewPath zich OldPath op hetzelfde station bevinden.
Rename kan geen nieuw bestand of nieuwe map maken.
Als u de Rename functie in een geopend bestand gebruikt, wordt er een fout gegenereerd. U moet een geopend bestand sluiten voordat u de naam ervan wijzigt.
Rename argumenten kunnen geen jokertekens met meerdere tekens (*) en jokertekens (?) bevatten.
Important
Wanneer u Rename een bestand vanaf een niet-beveiligde locatie naar een beveiligde locatie kopieert, behoudt het bestand de minder beperkte rechten. Controleer of u geen mogelijk beveiligingsrisico introduceert.