My.Computer.FileSystem.DeleteDirectory-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Löscht ein Verzeichnis.

' Usage
My.Computer.FileSystem.DeleteDirectory(directory ,onDirectoryNotEmpty)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal onDirectoryNotEmpty As DeleteDirectoryOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parameter

directory
String. Das zu löschende Verzeichnis. Erforderlich.
onDirectoryNotEmpty
DeleteDirectoryOption-Enumeration. Gibt an, was geschehen soll, wenn ein zu löschendes Verzeichnis Dateien oder Verzeichnisse enthält. Der Standardwert ist DeleteDirectoryOption.DeleteAllContents.
showUI
UIOption-Enumeration. Gibt an, ob der Status des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs. Erforderlich.
recycle
RecycleOption-Enumeration. Gibt an, ob die gelöschte Datei in den Papierkorb verschoben werden soll. Der Standardwert ist RecycleOption.DeletePermanently.
onUserCancel
UICancelOption-Enumeration. Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn der Benutzer auf Abbrechen klickt. Erforderlich.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Der Pfad ist eine Zeichenfolge der Länge 0 (null), ist falsch formatiert, enthält nur Leerzeichen oder enthält ungültige Zeichen (einschließlich Platzhalterzeichen) (ArgumentException).
Der Pfad ist ein Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist Nothing (ArgumentNullException).
Das Verzeichnis ist nicht vorhanden oder ist eine Datei (DirectoryNotFoundException).
Das Verzeichnis ist nicht leer, und onDirectoryNotEmpty ist auf ThrowIfDirectoryNonEmpty festgelegt (IOException).
Der Benutzer verfügt über keine Berechtigung zum Löschen des Verzeichnisses oder Unterverzeichnisses (IOException).
Eine Datei im Verzeichnis oder Unterverzeichnis wird gegenwärtig verwendet (IOException).
Ein Datei- oder Verzeichnisname enthält einen Doppelpunkt (:) (NotSupportedException).
Der Benutzer bricht den Vorgang ab, oder das Verzeichnis kann nicht gelöscht werden (OperationCanceledException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Der Benutzer verfügt nicht über erforderliche Berechtigungen (SecurityException).

Hinweise

Der showUI-Parameter, der recycle-Parameter und der onUserCancel-Parameter werden in Anwendungen nicht unterstützt, die keinen interaktiven Modus aufweisen, z. B. in Windows-Diensten.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.DeleteDirectory-Methode.

Zweck	Weitere Informationen finden Sie unter
Löschen eines Verzeichnisses	Gewusst wie: Löschen eines Verzeichnisses in Visual Basic

Beispiel

Im Beispiel wird das Verzeichnis OldDirectory nur gelöscht, wenn es leer ist.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

In diesem Beispiel werden das Verzeichnis OldDirectory und sein gesamter Inhalt gelöscht.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.DeleteAllContents)

In diesem Beispiel werden das Verzeichnis OldDirectory und sein gesamter Inhalt gelöscht. Der Benutzer wird gebeten, den Löschvorgang zu bestätigen, doch der Inhalt wird nicht in den Papierkorb verschoben.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.DeletePermanently, FileIO.UICancelOption.ThrowException)

In diesem Beispiel wird das Verzeichnis OldDirectory mit seinem gesamten Inhalt gelöscht und in den Papierkorb verschoben, doch der Status des Vorgangs wird nicht angezeigt.

My.Computer.FileSystem.DeleteDirectory("C:\OldDirectory", _
 FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

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 folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows.