FileSystem.RenameFile(String, String) Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Zdroj:

FileSystem.vb

Přejmenuje soubor.

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile (string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

Parametry

file

String

Soubor, který se má přejmenovat.

newName

String

Nový název souboru.

Výjimky

ArgumentException

newName obsahuje informace o cestě nebo končí zpětným lomítkem (\).

ArgumentNullException

file je Nothing.

-nebo-

newName je Nothing nebo prázdný řetězec.

FileNotFoundException

Adresář neexistuje.

IOException

Existuje existující soubor nebo adresář s názvem zadaným v newName.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

UnauthorizedAccessException

Uživatel nemá požadované oprávnění.

Příklady

Tento příklad přejmenuje soubor Test.txt na SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Změňte "C:\Test.txt" na cestu a název souboru, který chcete přejmenovat.

Poznámky

Tuto metodu nelze použít k přesunutí souboru; MoveFile pomocí metody soubor přesuňte a přejmenujte.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.RenameFile .

Záměr	Seznamte se s
Přejmenování souboru	Postupy: Přejmenování souboru v jazyce Visual Basic