Freigeben über

Gewusst wie: Umbenennen einer Datei in Visual Basic

  • Artikel

Aktualisiert: November 2007

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 Ausschnitten in den Code (Visual Basic).

Robuste Programmierung

Unter den folgenden Umständen können Ausnahmen auftreten:

  • Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0, der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (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 einer Datei in Visual Basic

Gewusst wie: Verschieben einer Auflistung von Dateien 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

My.Computer.FileSystem.RenameFile-Methode

Weitere Ressourcen

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