My.Computer.FileSystem.RenameDirectory-Methode
Aktualisiert: November 2007
Benennt ein Verzeichnis um.
' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
ByVal directory As String, _
ByVal newName As String _
)
Parameter
directory
String. Pfad und Name des umzubenennenden Verzeichnisses. Erforderlich.newName
String. Der neue Name für das Verzeichnis. Erforderlich.
Ausnahmen
Die folgenden Bedingungen können eine Ausnahme verursachen:
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der newName -Parameter enthält Pfadinformationen (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
Der newName-Parameter ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).
Das Quellverzeichnis ist ungültig oder nicht vorhanden (DirectoryNotFoundException).
Der Name einer vorhandenen Datei oder eines vorhandenen Verzeichnisses ist in newName angegeben (IOException).
Das Verzeichnis ist ein Stammverzeichnis (IOException).
Der Pfad enthält mehr als 248 Zeichen (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).
Hinweise
Diese Methode kann nicht zum Verschieben von Verzeichnissen verwendet werden. Verwenden Sie zum Verschieben und Umbenennen des Verzeichnisses die MoveDirectory-Methode.
Aufgaben
Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.RenameDirectory-Methode.
Zweck |
Weitere Informationen finden Sie unter |
|---|---|
Umbenennen eines Verzeichnisses |
Gewusst wie: Umbenennen eines Verzeichnisses in Visual Basic |
Beispiel
In diesem Beispiel wird das Verzeichnis Test in SecondTest umbenannt.
My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")
Anforderungen
Namespace: Microsoft.VisualBasic.MyServices
Klasse: FileSystemProxy (ermöglicht den Zugriff auf FileSystem)
Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)
Verfügbarkeit nach Projekttyp
Projekttyp |
Verfügbar |
|---|---|
Windows-Anwendung |
Ja |
Klassenbibliothek |
Ja |
Konsolenanwendung |
Ja |
Windows-Steuerelementbibliothek |
Ja |
Web-Steuerelementbibliothek |
Ja |
Windows-Dienst |
Ja |
Website |
Ja |
Berechtigungen
Die folgende Berechtigung ist möglicherweise erforderlich:
Berechtigung |
Beschreibung |
|---|---|
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.
Siehe auch
Aufgaben
Gewusst wie: Analysieren von Dateipfaden in Visual Basic
Referenz
My.Computer.FileSystem.MoveDirectory-Methode
Weitere Ressourcen
Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic