Condividi tramite

Procedura: Rinominare un file in Visual Basic

In Visual Basic esistono due modi per rinominare un file. È possibile utilizzare l'oggetto My.Computer.FileSystem runtime di Visual Basic o l'oggetto fornito System.IO.File da .NET per rinominare un file.

Rinominare con .NET

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

Nell'esempio seguente viene rinominato il file che si trova nella My Documents cartella 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

Utilizzare il RenameFile metodo 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 una directory diversa. Per informazioni su come spostare un file, vedere Procedura: Spostare un file in Visual Basic.

Nell'esempio seguente viene rinominato il file che si trova nella My Documents cartella 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 - Elaborazione di unità, cartelle e file. Per altre informazioni, vedere Frammenti di Codice.

Programmazione affidabile

Le condizioni seguenti possono causare un'eccezione:

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

Vedere anche

  • Last updated on