Gewusst wie: Umbenennen einer Datei in Visual Basic

Verwenden Sie die RenameFile-Methode des My.Computer.FileSystem-Objekts, um eine Datei umzubenennen, indem Sie den aktuellen Standort, Dateinamen sowie den neuen Dateinamen bereitstellen. Diese Methode kann nicht dazu verwendet werden, um eine Datei zu verschieben; verwenden Sie die MoveFile-Methode, um die Datei zu verschieben und umzubenennen.

So benennen Sie eine Datei um

  • Verwenden Sie die My.Computer.FileSystem.RenameFile-Methode, um eine Datei umzubenennen. In diesem Beispiel wird die Datei 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 befindet sich der Ausschnitt unter Dateisystem - Verarbeiten von Laufwerken, Ordnern und Dateien. Weitere Informationen finden Sie unter Codeausschnitte.

Stabile Programmierung

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

  • Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge 0, er enthält nur Leerzeichen, er enthält ungültige Zeichen, oder er ist ein 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).

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

  • 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 hat nicht die erforderliche Berechtigung (UnauthorizedAccessException).

Siehe auch

RenameFile
Gewusst wie: Verschieben einer Datei
Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen
Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Verzeichnis
Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis