Sdílet prostřednictvím


FileSystem.Rename(String, String) Metoda

Definice

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 -> unit
static member Rename : string * string -> unit
Public 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.

Platí pro

Viz také