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
Datei, die umbenannt werden soll.
- newName
- String
Neuer Dateiname.
Ausnahmen
newName enthält Pfadinformationen oder endet mit einem umgekehrten Schrägstrich (\).
Die Datei ist nicht vorhanden.
Es gibt eine vorhandene Datei oder ein Verzeichnis mit dem in newName.
Der Pfad überschreitet die vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.
Der Benutzer verfügt nicht über erforderliche Berechtigungen.
Beispiele
In diesem Beispiel wird die Datei Test.txt in SecondTest.txt.
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 zum Verschieben einer Datei verwendet werden. 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.
| To | Siehe |
|---|---|
| Umbenennen einer Datei | Vorgehensweise: Umbenennen einer Datei |