Condividi tramite


Procedura: rinominare un file in Visual Basic

Utilizzare il metodo RenameFile dell'oggetto My.Computer.FileSystem per rinominare un file fornendo la posizione corrente, il nome file e il nuovo nome file. Questo metodo non può essere utilizzato per spostare un file; utilizzare il metodo MoveFile per spostare e rinominare il file.

Per rinominare un file

  • Utilizzare il metodo My.Computer.FileSystem.RenameFile per 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 è anche disponibile 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 ulteriori informazioni, vedere Procedura: inserire frammenti di codice IntelliSense.

Programmazione efficiente

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 un dispositivo, ovvero 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 esistente con 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).

Vedere anche

Attività

Procedura: spostare un file in Visual Basic

Procedura: spostare un insieme di file in Visual Basic

Procedura: creare una copia di un file nella stessa directory in Visual Basic

Procedura: creare una copia di un file in una directory diversa in Visual Basic

Riferimenti

RenameFile

Altre risorse

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