FileSystem.RenameFile(String, String) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

FileSystem.vb

Rinomina un file.

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)

Parametri

file

String

File da rinominare.

newName

String

Nuovo nome del file.

Eccezioni

ArgumentException

newName contiene informazioni sul percorso o termina con una barra rovesciata (\).

ArgumentNullException

file è Nothing.

-oppure-

newName è Nothing o una stringa vuota.

FileNotFoundException

La directory non esiste.

IOException

È disponibile un file o directory esistente con il nome specificato in newName.

PathTooLongException

La lunghezza del percorso supera la lunghezza massima definita dal sistema.

NotSupportedException

Nel nome di un file o di una directory del percorso sono presenti i due punti (:) oppure il relativo formato non è valido.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso.

UnauthorizedAccessException

L'utente non dispone dell'autorizzazione necessaria.

Esempio

In questo esempio il file Test.txt viene rinominato in SecondTest.txt.

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

Modificare "C:\Test.txt" con il percorso e il nome file del file da rinominare.

Commenti

Questo metodo non può essere usato per spostare un file. Per spostare e rinominare un file, usare il metodo MoveFile.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.FileSystem.RenameFile metodo .

A	Vedere
Rinominare un file	Procedura: rinominare un file in Visual Basic