Freigeben über

Gewusst wie: Umbenennen einer Datei in Visual Basic

  • Artikel

In Visual Basic gibt es zwei Möglichkeiten, eine Datei umzubenennen. Sie können das Visual Basic-Laufzeitobjekt My.Computer.FileSystem oder das von .NET bereitgestellte Objekt System.IO.File verwenden, um eine Datei umzubenennen.

Umbenennen mit .NET

Das System.IO.File-Objekt enthält keine Methode, um eine Datei umzubenennen. Verwenden Sie stattdessen die Methode Move, um die Datei an denselben Speicherort zu „verschieben“, jedoch mit einem anderen Dateinamen. Diese Methode kann auch verwendet werden, um die Datei mit einem anderen Namen an einen anderen Speicherort zu verschieben, indem sie gleichzeitig verschoben und umbenennt wird.

Im folgenden Beispiel wird die Datei im Ordner My Documents von TextFile.txt in NewName.txt umbenannt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Umbenennen mit der Visual Basic-Laufzeit

Verwenden Sie die RenameFile-Methode des My.Computer.FileSystem-Objekts, um eine Datei umzubenennen, indem Sie den vollständigen Pfad zur Datei sowie den neuen Dateinamen bereitstellen. Diese Methode kann nicht verwendet werden, um eine Datei in ein anderes Verzeichnis zu verschieben. Informationen zum Verschieben einer Datei finden Sie unter Gewusst wie: Verschieben von Dateien in Visual Basic.

Im folgenden Beispiel wird die Datei im Ordner My Documents von TextFile.txt in NewName.txt umbenannt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

Visual Studio stellt einen IntelliSense-Codeschnipsel bereit, der My.Computer.FileSystem.RenameFile verwendet. Der Codeschnipsel befindet sich 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 NULL, 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 ist nicht vorhanden (FileNotFoundException).
  • Eine Datei oder ein Verzeichnis mit dem in newName angegebenen Namen ist bereits 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).

Weitere Informationen