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 lepší produktivitu a výkon při vstupně-výstupních operacích souborů než Rename. Další informace najdete na webu 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
Required. Ř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
Required. Řetězcový výraz, který určuje nový název a umístění souboru.
NewPath může obsahovat adresář a jednotku cílového umístění. Název souboru určený 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 již existují adresáře, které jsou zadány.
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 může přejmenovat pouze existující adresář, pokud se nachází NewPathOldPath na stejné jednotce a nachází se na stejné jednotce.
Rename aplikace nemůže vytvořit nový soubor nebo adresář.
Rename Použití funkce v otevřeném souboru způsobí chybu. Před přejmenováním musíte otevřít soubor zavřít.
Rename Argumenty nemohou obsahovat zástupné znaky s více znaky (*) a jednoznačky (?).
Important
Při kopírování Rename souboru z nechráněného umístění do chráněného umístění zachová soubor méně omezená práva. Ujistěte se, že nezavádět možné bezpečnostní riziko.
