Freigeben über


FileSystem.Rename(String, String) Methode

Definition

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

Ausnahmen

Der Pfad ist ungültig.

Die OldPath-Datei ist nicht vorhanden.

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:

Weitere Informationen