Procedura: rinominare un file in Visual Basic
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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per