FileSystem.Rename(String, String) Metodo

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Rinomina un file o una directory del disco. La My funzionalità offre una maggiore produttività e prestazioni nelle operazioni di I/O dei file rispetto a Rename. Per altre informazioni, vedere FileSystem.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
public static void Rename(string OldPath, string NewPath);
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

Parametri

OldPath
String

Required. Espressione stringa che specifica il nome e il percorso del file esistenti. OldPath può includere la directory e l'unità del file.

NewPath
String

Required. Espressione stringa che specifica il nuovo nome file e il percorso. NewPath può includere directory e unità del percorso di destinazione. Il nome file specificato da NewPath non può esistere già.

Eccezioni

ArgumentException

Percorso non valido.

FileNotFoundException

OldPath file non esistente.

IOException

Impossibile rinominare un dispositivo diverso.

Esempio

In questo esempio viene utilizzata la Rename funzione per rinominare un file. Ai fini di questo esempio, si supponga che le directory specificate esistano già.

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)

Commenti

LaRename funzione rinomina un file e lo sposta in una directory diversa, se necessario. La Rename funzione può spostare un file tra unità, ma può rinominare solo una directory esistente quando entrambi NewPath e OldPath si trovano nella stessa unità. Rename impossibile creare un nuovo file o una nuova directory.

L'uso della Rename funzione in un file aperto genera un errore. Prima di rinominarlo, è necessario chiudere un file aperto. Rename gli argomenti non possono includere caratteri jolly (*) e caratteri singoli (?).

Important

Quando si usa Rename per copiare un file da un percorso non protetto in un percorso protetto, il file mantiene i diritti meno limitati. Verificare di non introdurre un possibile rischio per la sicurezza.

Si applica a

Vedi anche