FileSystem.Rename(String, String) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rinomina un file o una directory su disco. La funzionalità My offre un livello più elevato di 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);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);

public static void Rename (string OldPath, string NewPath);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit

static member Rename : string * string -> unit

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

Parametri

OldPath: String

Obbligatorio. Espressione stringa che specifica il nome file esistente e il relativo percorso. L'oggetto OldPath può includere la directory e l'unità del file.

NewPath: String

Obbligatorio. Espressione stringa che specifica il nuovo nome file e il relativo percorso. L'oggetto NewPath può includere la directory e l'unità del percorso di destinazione. Il nome file specificato da NewPath non deve esistere.

Attributi: SupportedOSPlatformAttribute

Eccezioni

ArgumentException

Il percorso non è valido.

FileNotFoundException

Il file OldPath non esiste.

IOException

Impossibile rinominare con il nome di un'altro dispositivo.

Esempio

In questo esempio viene usata 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 una directory esistente solo 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. È necessario chiudere un file aperto prima di rinominarlo. Rename gli argomenti non possono includere caratteri jolly (*) e carattere singolo (?).

Importante

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

Condividi tramite