Gewusst wie: Umbenennen eines Verzeichnisses in Visual Basic

Aktualisiert: November 2007

Die RenameDirectory-Methode des My.Computer.FileSystem-Objekts kann zum Umbenennen eines Verzeichnisses verwendet werden, indem der aktuelle Speicherort und Name des Verzeichnisses zusammen mit dem neuen Namen des Verzeichnisses angegeben werden. Diese Methode kann nicht zum Verschieben von Verzeichnissen verwendet werden. Verwenden Sie zum Verschieben und Umbenennen des Verzeichnisses die MoveDirectory-Methode.

So benennen Sie ein Verzeichnis um

  • Verwenden Sie zum Umbenennen eines Verzeichnisses die My.Computer.FileSystem.RenameDirectory-Methode. Im folgenden Code wird das Verzeichnis Test in SecondTest umbenannt.

    My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", _
    "SecondTest")
    

Dieses Codebeispiel ist auch als IntelliSense-Codeausschnitt verfügbar. In der Codeausschnittauswahl finden Sie das Beispiel 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

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

  • 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).

  • Das Quellverzeichnis ist ungültig oder nicht vorhanden (DirectoryNotFoundException).

  • Es ist eine Datei oder ein Ordner mit dem in newName angegebenen Namen vorhanden (IOException).

  • Der Ordner ist ein Stammordner (IOException).

  • Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).

  • Ein Datei- oder Ordnername im Pfad 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: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Gewusst wie: Analysieren von Dateipfaden in Visual Basic

Gewusst wie: Verschieben eines Verzeichnisses in Visual Basic

Gewusst wie: Verschieben des Inhalts eines Verzeichnisses in Visual Basic

Referenz

My.Computer.FileSystem.RenameDirectory-Methode