FileSystem.Rename(String, String) Methode
Definition
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 Ihnen eine bessere Produktivität und Leistung in Datei-E/A-Vorgängen als Rename. Weitere Informationen finden Sie unter FileSystem.
public:
static void Rename(System::String ^ OldPath, System::String ^ NewPath);public static void Rename(string OldPath, string NewPath);static member Rename : string * string -> unitPublic Sub Rename (OldPath As String, NewPath As String)Parameter
- OldPath
- String
Required. Ein Zeichenfolgenausdruck, der den vorhandenen Dateinamen und Speicherort angibt.
OldPath kann das Verzeichnis und das Laufwerk der Datei enthalten.
- NewPath
- String
Required. Ein Zeichenfolgenausdruck, der den neuen Dateinamen und Speicherort angibt.
NewPath kann Verzeichnis und Laufwerk des Zielspeicherorts enthalten. Der angegebene NewPath Dateiname kann nicht bereits vorhanden sein.
Ausnahmen
Der Pfad ist ungültig.
OldPath Datei ist nicht vorhanden.
Es kann nicht in ein anderes Gerät umbenannt werden.
Beispiele
In diesem Beispiel wird die Rename Funktion verwendet, um eine Datei umzubenennen. Gehen Sie für dieses Beispiel davon aus, 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 in ein anderes Verzeichnis, falls erforderlich. Die Rename Funktion kann eine Datei über Laufwerke verschieben, aber es kann nur ein vorhandenes Verzeichnis umbenennen, wenn sich beide NewPath befinden und OldPath sich auf demselben Laufwerk befinden.
Rename Eine neue Datei oder ein neues Verzeichnis kann nicht erstellt werden.
Die Verwendung der Rename Funktion in einer geöffneten Datei erzeugt einen Fehler. Sie müssen eine geöffnete Datei schließen, bevor Sie sie umbenennen.
Rename Argumente können keine Platzhalter mit mehreren Zeichen (*) und Einzeichen (?) enthalten.
Important
Rename Wenn Sie eine Datei aus einem nicht geschützten Speicherort in einen geschützten Speicherort kopieren, behält die Datei die weniger eingeschränkten Rechte bei. Überprüfen Sie, ob Sie kein mögliches Sicherheitsrisiko einführen.