Funzione Rename

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rinomina un file o una directory nel disco.

Nelle operazioni di I/O dei file la funzionalità My offre un più elevato livello di produttività e prestazioni rispetto a Rename. Per ulteriori informazioni, vedere Oggetto My.Computer.FileSystem.

Public Sub Rename( _
   ByVal OldPath As String, _
   ByVal NewPath As String _
)

Parametri

OldPath
Obbligatorio. Espressione String che specifica il nome e il percorso del file esistente. In OldPath è possibile includere la directory e l'unità del file.
NewPath
Obbligatorio. Espressione String che specifica il nome e il percorso del nuovo file. In NewPath è possibile includere la directory e l'unità del percorso di destinazione. Il nome di file specificato da NewPath non può corrispondere a un file già esistente.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Percorso non valido.
FileNotFoundException	53	Il file OldPath non esiste.
IOException	58	Il file NewPath esiste già.
IOException	75	Accesso non valido.
IOException	74	Impossibile rinominare con il nome di un'altra periferica.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La funzione Rename consente di rinominare un file e spostarlo, se necessario, in un'altra directory. La funzione Rename è in grado di spostare un file da un'unità a un'altra, ma può rinominare una directory esistente soltanto se NewPath e OldPath si trovano nella stessa unità. Non è possibile utilizzare Rename per creare un nuovo file o una nuova directory.

Se la funzione Rename viene utilizzata con un file aperto, verrà generato un errore. Per rinominare un file aperto, è necessario prima chiuderlo. Negli argomenti della funzione Rename non sono consentiti caratteri jolly in sostituzione di caratteri multipli (*) e singoli (?).

Nota sulla sicurezza:
Se la funzione Rename viene utilizzata per copiare un file da un percorso non protetto in uno protetto, il file manterrà i diritti meno restrittivi. Assicurarsi di non introdurre possibili elementi di rischio per la protezione.

Esempio

Nell'esempio riportato di seguito la funzione Rename viene utilizzata per rinominare un file. Ai fini dell'esempio, le directory specificate vengono considerate esistenti.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)