Procedura: rinominare un file in Visual Basic

Usare il metodo RenameFile dell'oggetto My.Computer.FileSystem per rinominare un file fornendo la posizione corrente, il nome file attuale e il nuovo nome file. Questo metodo non può essere usato per spostare un file. Per spostare e rinominare un file, usare il metodo MoveFile.

Per rinominare un file

  • Usare il metodo My.Computer.FileSystem.RenameFileper rinominare un file. In questo esempio il file Test.txt viene rinominato in SecondTest.txt.

    ' Change "c:\test.txt" to the path and filename for the file that
    ' you want to rename.
    My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
    

Questo esempio di codice è disponibile anche come frammento di codice IntelliSense. Nella casella di selezione dei frammenti di codice il frammento si trova in File system - Elaborazione di unità, 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, 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 delle autorizzazioni necessarie (UnauthorizedAccessException).

Vedi anche