FileSystemProxy.RenameFile(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 Datei um.
public:
void RenameFile(System::String ^ file, System::String ^ newName);public void RenameFile (string file, string newName);member this.RenameFile : string * string -> unitPublic Sub RenameFile (file As String, newName As String)Parameter
- file
- String
Die Datei, die umbenannt werden soll.
- newName
- String
Neuer Name der Datei.
Ausnahmen
newName enthält Pfadinformationen oder endet mit einem umgekehrten Schrägstrich (\).
file ist Nothing.
- oder -
Der newName ist Nothing oder eine leere Zeichenfolge.
Die Datei ist nicht vorhanden.
Es ist eine Datei oder ein Verzeichnis mit dem in newName angegebenen Namen vorhanden.
Der Pfad überschreitet die im System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.
Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.
Der Benutzer verfügt nicht über die erforderliche Berechtigung.
Beispiele
In diesem Beispiel wird die Datei Test.txt in SecondTest.txtumbenannt.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
Ändern Sie "C:\Test.txt" in den Pfad und Dateinamen der Datei, die Sie umbenennen möchten.
Hinweise
Diese Methode kann nicht dazu verwendet werden, um eine Datei zu verschieben; verwenden Sie die MoveFile-Methode, um die Datei zu verschieben und umzubenennen.
In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.RenameFile -Methode umfasst.
| Beschreibung | Siehe |
|---|---|
| Umbenennen einer Datei | Vorgehensweise: Umbenennen einer Datei |
