Metodo My.Computer.FileSystem.RenameFile

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rinomina un file.

' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
   ByVal file As String, _
   ByVal newName As String _
)

Parametri

file
String. File da rinominare. Obbligatorio.
newName
String. Nuovo nome del file. Obbligatorio.

Eccezioni

Le seguenti condizioni possono generare un'eccezione:

Il percorso non è valido per uno dei seguenti motivi: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di una periferica, vale a dire inizia con \\.\ (ArgumentException).
Il parametro newName contiene informazioni sul percorso o termina con una barra rovesciata (\) (ArgumentException).
Il percorso non è valido in quanto Nothing (ArgumentNullException).
Il parametro newName è Nothing o una stringa vuota (ArgumentNullException).
Il file di origine non è valido o non esiste (FileNotFoundException).
Un file o una directory già esistenti hanno il nome specificato in newName (IOException).
La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
Un nome di file o di directory nel percorso contiene i due punti (:) o ha un formato non valido (NotSupportedException).
L'utente non dispone delle autorizzazioni necessarie per visualizzare il percorso (SecurityException).
L'utente non dispone delle autorizzazioni necessarie (UnauthorizedAccessException).

Note

Non è possibile utilizzare questo metodo per spostare un file; per spostare e rinominare un file, utilizzare l'oggetto Metodo My.Computer.FileSystem.MoveFile.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.FileSystem.RenameFile.

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

Esempio

Nell'esempio, il file Test.txt viene rinominato in SecondTest.txt.

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

Modificare "C:\Test.txt" nel percorso e nel nome file che si desidera rinominare.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornisce l'accesso a FileSystem)

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	Sì
Servizio Windows	Sì
Sito Web	Sì

Autorizzazioni

Può essere necessaria l'autorizzazione seguente:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Riferimenti

Oggetto My.Computer.FileSystem

FileSystem.RenameFile

Altre risorse

Creazione, eliminazione e spostamento di file e directory in Visual Basic

Condividi tramite