My.Computer.FileSystem.RenameFile-Methode

Aktualisiert: November 2007

Benennt eine Datei um.

' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
   ByVal file As String, _
   ByVal newName As String _
)

Parameter

• file
  String. Die umzubenennende Datei. Erforderlich.

• newName
  String. Der neue Name der Datei. Erforderlich.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

• Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).

• Der newName -Parameter enthält Pfadinformationen oder endet mit einem umgekehrten Schrägstrich (\) (ArgumentException).

• Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).

• Der newName-Parameter ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).

• Die Quelldatei ist ungültig oder nicht vorhanden (FileNotFoundException).

• Der Name einer vorhandenen Datei oder eines vorhandenen Verzeichnisses ist in newName angegeben (IOException).

• Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).

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

• Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).

• Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).

Hinweise

Diese Methode kann nicht zum Verschieben von Dateien verwendet werden. Verwenden Sie zum Verschieben und Umbenennen der Datei die My.Computer.FileSystem.MoveFile-Methode.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.RenameFile-Methode.

Beispiel

In diesem Beispiel wird die Datei Test.txt in SecondTest.txt umbenannt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Ändern von "C:\Test.txt" in den Pfad und Dateinamen der umzubenennenden Datei.

Anforderungen

Namespace: Microsoft.VisualBasic.MyServices

Klasse: FileSystemProxy (ermöglicht den Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Computer.FileSystem-Objekt

FileSystem.RenameFile

Weitere Ressourcen

Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic