FileSystemProxy.RenameFile(String, String) Metoda

Reference

Definice

Obor názvů:: Microsoft.VisualBasic.MyServices

Sestavení:: Microsoft.VisualBasic.dll

Sestavení:: Microsoft.VisualBasic.Forms.dll

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 soubor.

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

public void RenameFile (string file, string newName);

member this.RenameFile : string * string -> unit

Public 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

Soubor 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

Platí pro

Sdílet prostřednictvím