Freigeben über

Gewusst wie: Umbenennen einer Datei in Visual Basic

  • Artikel

Verwenden Sie die RenameFile-Methode des My.Computer.FileSystem-Objekts zum Umbenennen von Dateien. Hierbei müssen Sie den aktuellen Speicherort, den Dateinamen und den neuen Dateinamen angeben. Diese Methode kann nicht zum Verschieben einer Datei verwendet werden. Verwenden Sie in diesem Fall die MoveFile-Methode, um die Datei zu verschieben und umzubenennen.

So benennen Sie eine Datei um

  • Verwenden Sie zum Umbenennen einer Datei die My.Computer.FileSystem.RenameFile-Methode. In diesem Beispiel wird die Datei mit dem Namen Test.txt in SecondTest.txt umbenannt.

    ' Change "c:\test.txt" to the path and filename for the file that
' you want to rename.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar. In der Codeausschnittauswahl finden Sie den Codeausschnitt unter Dateisystem - Verarbeiten von Laufwerken, Ordnern und Dateien. Weitere Informationen finden Sie unter Gewusst wie: Einfügen von IntelliSense-Codeausschnitten.

Robuste Programmierung

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

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

  • newName enthält Pfadinformationen (ArgumentException).

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

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

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

  • Es ist eine Datei oder ein Verzeichnis mit dem in newName angegebenen Namen vorhanden (IOException).

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

  • Der Pfad eines Datei- oder Verzeichnisnamens enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).

  • Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfades (SecurityException).

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

Siehe auch

Aufgaben

Gewusst wie: Verschieben von Dateien in Visual Basic

Gewusst wie: Verschieben von Dateiauflistungen in Visual Basic

Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic

Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Referenz

RenameFile

Weitere Ressourcen

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