My.Computer.FileSystem.RenameFile-Methode

Artikel
08/20/2008

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.

Zweck	Weitere Informationen finden Sie unter
Umbenennen einer Datei	Gewusst wie: Umbenennen einer Datei in Visual Basic

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

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.

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

Freigeben über