Condividi tramite

Procedura: rinominare un file in Visual Basic

  • Articolo

In Visual Basic sono disponibili due modi per rinominare un file. Per rinominare un file, è possibile usare l'oggetto di runtime di Visual Basic My.Computer.FileSystem o l'oggetto System.IO.File fornito da .NET.

Rinominare con .NET

L'oggetto System.IO.File non contiene un metodo per rinominare un file, usare invece il metodo Move per "spostare" il file nella stessa posizione, ma con un nome file diverso. Questo metodo può essere usato anche per spostare il file in una posizione diversa con un nome diverso, eseguendo al contempo uno spostamento e una ridenominazione.

Nell'esempio seguente il file che si trova nella cartella My Documents viene rinominato da TextFile.txt a NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Rinominare con il runtime di Visual Basic

Usare il metodo RenameFile dell'oggetto My.Computer.FileSystem per rinominare un file specificando il percorso completo del file e il nuovo nome file. Questo metodo non può essere usato per spostare un file in un'altra directory. Per informazioni su come spostare un file, vedere Procedura: spostare un file in Visual Basic.

Nell'esempio seguente il file che si trova nella cartella My Documents viene rinominato da TextFile.txt a NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

Visual Studio fornisce un frammento di codice IntelliSense che usa My.Computer.FileSystem.RenameFile. Il frammento di codice si trova in File system - Unità di elaborazione, cartelle e file. Per altre informazioni, vedere Code Snippets.

Programmazione efficiente

Le seguenti condizioni possono generare un'eccezione:

  • Il percorso non è valido per uno dei motivi seguenti: è una stringa di lunghezza zero, contiene solo spazi vuoti, contiene caratteri non validi o è il percorso di un dispositivo (inizia con \\.\)(ArgumentException).
  • newName contiene informazioni sul percorso (ArgumentException).
  • Il percorso non è valido in quanto è Nothing (ArgumentNullException).
  • newName è Nothing o una stringa vuota (ArgumentNullException).
  • Il file di origine non è valido o non esiste (FileNotFoundException).
  • Esiste un file o directory con il nome specificato in newName (IOException).
  • La lunghezza del percorso supera la lunghezza massima definita dal sistema (PathTooLongException).
  • Il nome di un file o di una 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 dell'autorizzazione richiesta (UnauthorizedAccessException).

Vedi anche