My.Computer.FileSystem.DeleteDirectory-Methode

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.

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

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Löschen einer Datei in Visual Basic

Gewusst wie: Löschen eines Verzeichnisses in Visual Basic

Referenz

My.Computer.FileSystem-Objekt

UICancelOption-Enumeration

FileSystem.DeleteDirectory

UICancelOption

RecycleOption-Enumeration

DeleteDirectoryOption-Enumeration

UICancelOption-Enumeration

UIOption-Enumeration