FileSystem.Rename(String, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přejmenuje diskový soubor nebo adresář. Tato My funkce poskytuje vyšší produktivitu a výkon při vstupně-výstupních operacích se soubory než Rename. Další informace naleznete v tématu 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)Parametry
- OldPath
- String
Povinná hodnota. Řetězcový výraz, který určuje název a umístění existujícího souboru.
OldPath může obsahovat adresář a jednotku souboru.
- NewPath
- String
Povinná hodnota. Řetězcový výraz, který určuje nový název souboru a umístění.
NewPath může obsahovat adresář a jednotku cílového umístění. Název souboru zadaný nástrojem NewPath již nemůže existovat.
- Atributy
Výjimky
Cesta je neplatná.
OldPath soubor neexistuje.
Nelze přejmenovat na jiné zařízení.
Příklady
Tento příklad používá Rename funkci k přejmenování souboru. Pro účely tohoto příkladu předpokládejme, že zadané adresáře již existují.
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)
Poznámky
FunkceRename přejmenuje soubor a v případě potřeby ho přesune do jiného adresáře. Funkce Rename může přesunout soubor mezi jednotkami, ale přejmenovat existující adresář může pouze v případě, že jsou na stejné jednotce i NewPathOldPath .
Rename Aplikace nemůže vytvořit nový soubor nebo adresář.
Při použití funkce v Rename otevřeném souboru dojde k chybě. Otevřený soubor musíte před přejmenováním zavřít.
Rename Argumenty nesmí obsahovat zástupné znaky s více znaky (*) a jednoznakový znak (?).
Důležité
Při použití příkazu Rename ke kopírování souboru z nechráněného umístění do chráněného umístění si soubor zachová méně omezená práva. Zkontrolujte, jestli nezanášíte možné bezpečnostní riziko.
