FileSystem.Rename(String, String) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lemezfájlt vagy könyvtárat nevez át. A My funkció jobb hatékonyságot és teljesítményt biztosít a fájl I/O-műveletekben, mint Renamea . További információért lásd 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éterek
- OldPath
- String
Kötelező. Egy sztringkifejezés, amely megadja a meglévő fájlnevet és helyet.
OldPath tartalmazhatja a fájl könyvtárát és meghajtóját.
- NewPath
- String
Kötelező. Egy sztringkifejezés, amely megadja az új fájlnevet és helyet.
NewPath tartalmazhatja a célhely könyvtárát és meghajtóját. A megadott NewPath fájlnév nem létezik.
- Attribútumok
Kivételek
Az elérési út érvénytelen.
OldPath fájl nem létezik.
Nem nevezhető át másik eszközre.
Példák
Ez a példa egy fájl átnevezéséhez használja a Rename függvényt. Ebben a példában feltételezzük, hogy a megadott könyvtárak már léteznek.
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)
Megjegyzések
ARename függvény átnevez egy fájlt, és szükség esetén egy másik könyvtárba helyezi át. A Rename függvény áthelyezhet egy fájlt a meghajtók között, de csak akkor nevezhet át egy meglévő könyvtárat, ha mindkettő NewPathOldPath ugyanazon a meghajtón található.
Rename Nem hozható létre új fájl vagy könyvtár.
Ha a Rename függvényt egy megnyitott fájlon használja, hibaüzenet jelenik meg. Az átnevezés előtt be kell zárnia egy megnyitott fájlt.
Rename Az argumentumok nem tartalmazhatnak több karakterből (*) és egykarakból álló (?) helyettesítő karaktereket.
Important
Rename Ha nem védett helyről védett helyre másol egy fájlt, a fájl megőrzi a kevésbé korlátozott jogosultságokat. Ellenőrizze, hogy nem vezet-e be biztonsági kockázatot.
