Freigeben über


FileSystem.RenameFile(String, String) Methode

Definition

Benennt eine Datei um.

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);
public static void RenameFile (string file, string newName);
static member RenameFile : string * string -> unit
Public Shared 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 Gewusst wie: Umbenennen einer Datei in Visual Basic

Gilt für: