FileSystem.RenameFile(String, String) Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

FileSystem.vb

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

ArgumentException

newName enthält Pfadinformationen oder endet mit einem umgekehrten Schrägstrich (\).

ArgumentNullException

file ist Nothing.

- oder -

Der newName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Datei ist nicht vorhanden.

IOException

Es ist eine Datei oder ein Verzeichnis mit dem in newName angegebenen Namen vorhanden.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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