Freigeben über

Vorgehensweise: Umbenennen einer Datei in Visual Basic

In Visual Basic gibt es zwei Möglichkeiten, eine Datei umzubenennen. Sie können das Visual Basic-Laufzeitobjekt My.Computer.FileSystem oder das bereitgestellte System.IO.File .NET-Objekt 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 Move Methode, um die Datei an denselben Speicherort zu "verschieben", aber mit einem anderen Dateinamen. Diese Methode kann auch verwendet werden, um die Datei an einen anderen Speicherort mit einem anderen Namen zu verschieben und umzubenennen.

Im folgenden Beispiel wird die Datei im My Documents-Ordner 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 zu der Datei und den neuen Dateinamen angeben. Diese Methode kann nicht verwendet werden, um eine Datei in ein anderes Verzeichnis zu verschieben. Informationen zum Verschieben einer Datei finden Sie unter How to: Move a File in Visual Basic.

Im folgenden Beispiel wird die Datei im My Documents-Ordner 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-Codeausschnitt bereit, der My.Computer.FileSystem.RenameFile verwendet. Der Codeausschnitt befindet sich im Dateisystem – Verarbeitung von Laufwerken, Ordnern und Dateien. Weitere Informationen finden Sie unter Codeschnipsel.

Robuste Programmierung

Die folgenden Bedingungen können eine Ausnahme verursachen:

  • Der Pfad ist aus einem der folgenden Gründe nicht gültig: Es handelt sich um eine leere Zeichenfolge, es enthält nur Leerzeichen, es 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 (ArgumentNullException) ist.
  • newName ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).
  • Die Quelldatei ist ungültig oder nicht vorhanden (FileNotFoundException).
  • Es gibt eine vorhandene Datei oder ein Verzeichnis mit dem angegebenen Namen newName (IOException).
  • Der Pfad überschreitet die vom System definierte maximale Länge (PathTooLongException).
  • Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder ist in einem ungültigen Format (NotSupportedException).
  • Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads (SecurityException).
  • Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).

Siehe auch