Condividi tramite


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

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)

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

Riferimenti

Funzione Kill

ArgumentException

FileNotFoundException

IOException