FileSystemProxy.RenameFile(String, String) Metoda

Definice

Obor názvů:
Microsoft.VisualBasic.MyServices
Sestavení:
Microsoft.VisualBasic.dll

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 přesuňte a přejmenujte soubor.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.FileSystem.RenameFile .

To Podívejte se
Přejmenování souboru Postupy: Přejmenování souboru

Platí pro

Viz také