FileSystem.Rename(String, String) Metoda

Reference

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

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 -> 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: SupportedOSPlatformAttribute

Výjimky

ArgumentException

Cesta je neplatná.

FileNotFoundException

OldPath soubor neexistuje.

IOException

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