Funzione Rename
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 |
---|---|---|
Percorso non valido. |
||
Il file OldPath non esiste. |
||
Il file NewPath esiste già. |
||
Accesso non valido. |
||
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)
Note per gli sviluppatori di applicazioni per Smart Device
Questa funzione non è supportata.
Requisiti
Spazio dei nomi:Microsoft.VisualBasic
**Modulo:**FileSystem
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Vedere anche
Attività
Procedura: rinominare un file in Visual Basic
Procedura: rinominare una directory in Visual Basic