FileSystem.Rename(String, String) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Benennt eine Datenträgerdatei oder ein Verzeichnis um. Das My-Feature bietet höhere Produktivität und Leistung bei Datei-E/A-Vorgängen als Rename. Weitere Informationen finden Sie unter 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)

Parameter

OldPath: String

Erforderlich. Ein Zeichenfolgenausdruck, der den Namen und den Speicherort der vorhandenen Datei angibt. OldPath kann das Verzeichnis und das Laufwerk der Datei beinhalten.

NewPath: String

Erforderlich. Ein Zeichenfolgenausdruck, der den Namen und den Speicherort der neuen Datei angibt. NewPath kann das Verzeichnis und das Laufwerk des Zielspeicherorts beinhalten. Der durch NewPath angegebene Dateiname darf noch nicht vorhanden sein.

Attribute: SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

Der Pfad ist ungültig.

FileNotFoundException

Die OldPath-Datei ist nicht vorhanden.

IOException

Kann nicht auf anderes Gerät umbenannt werden.

Beispiele

In diesem Beispiel wird die Rename -Funktion verwendet, um eine Datei umzubenennen. Für dieses Beispiel wird davon ausgegangen, dass die angegebenen Verzeichnisse bereits vorhanden sind.

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)

Hinweise

DieRename Funktion benennt eine Datei um und verschiebt sie bei Bedarf in ein anderes Verzeichnis. Die Rename Funktion kann eine Datei über Laufwerke verschieben, aber sie kann nur ein vorhandenes Verzeichnis umbenennen, wenn sich beide NewPath und OldPath auf demselben Laufwerk befinden. Rename kann keine neue Datei oder ein neues Verzeichnis erstellen.

Die Verwendung der Rename -Funktion für eine geöffnete Datei führt zu einem Fehler. Sie müssen eine geöffnete Datei schließen, bevor Sie sie umbenennen. Rename Argumente dürfen keine Platzhalter mit mehreren Zeichen (*) und einstelligen Zeichen (?) enthalten.

Wichtig

Wenn Sie verwenden Rename , um eine Datei aus einem ungeschützten Speicherort an einen geschützten Speicherort zu kopieren, behält die Datei die weniger eingeschränkten Rechte bei. Überprüfen Sie, ob Sie kein mögliches Sicherheitsrisiko einführen.

Gilt für: