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 \\.\) (<xref:System.ArgumentException>).

  • newName enthält Pfadinformationen (<xref:System.ArgumentException>).

  • Der Pfad ist ungültig, da er Nothing ist (<xref:System.ArgumentNullException>).

  • newName ist Nothing oder eine leere Zeichenfolge (<xref:System.ArgumentNullException>).

  • Die Quelldatei ist ungültig oder nicht vorhanden (<xref:System.IO.FileNotFoundException>).

  • Eine Datei oder ein Verzeichnis mit dem in newName angegebenen Namen (<xref:System.IO.IOException>) ist bereits vorhanden.

  • Der Pfad überschreitet die im System definierte maximale Länge (<xref:System.IO.PathTooLongException>).

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

  • Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfades (<xref:System.Security.SecurityException>).

  • Der Benutzer hat nicht die erforderliche Berechtigung (<xref:System.UnauthorizedAccessException>).

Siehe auch

<xref:Microsoft.VisualBasic.FileIO.FileSystem.RenameFile%2A>
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