FileSystem.DeleteDirectory Methode

Definition

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Löscht ein Verzeichnis.

Überlädt

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Löscht ein Verzeichnis.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parameter

directory
String

Verzeichnis, das gelöscht werden soll.

showUI
UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Gibt an, ob die gelöschte Datei an den Papierkorb gesendet werden soll. Der Standardwert ist RecycleOption.DeletePermanently.

onUserCancel
UICancelOption

Gibt an, ob eine Ausnahme ausgelöst werden soll, wenn der Benutzer auf "Abbrechen" klickt.

Ausnahmen

ArgumentException

Der Pfad ist eine leere Zeichenfolge, ist falsch formatiert, enthält nur Leerzeichen oder enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden oder ist eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

Der Pfad überschreitet die vom System definierte maximale Länge.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

OperationCanceledException

Der Benutzer bricht den Vorgang ab, oder das Verzeichnis kann nicht gelöscht werden.

Beispiele

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 wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht, der Benutzer aufgefordert, den Löschvorgang zu bestätigen, aber den Inhalt nicht in den Papierkorb zu senden.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht und an den Papierkorb gesendet, der Fortschritt des Vorgangs wird jedoch nicht angezeigt.

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

Hinweise

Die Parameter showUI, recycle und onUserCancel werden in Anwendungen, die nicht interaktiv sind, wie z. B. Windows Dienste, nicht unterstützt.

Weitere Informationen

Gilt für:

DeleteDirectory(String, UIOption, RecycleOption)

Löscht ein Verzeichnis.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);
public static void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit
Public Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)

Parameter

directory
String

Verzeichnis, das gelöscht werden soll.

showUI
UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Gibt an, ob die gelöschte Datei an den Papierkorb gesendet werden soll. Der Standardwert ist RecycleOption.DeletePermanently.

Ausnahmen

ArgumentException

Der Pfad ist eine leere Zeichenfolge, ist falsch formatiert, enthält nur Leerzeichen oder enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden oder ist eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

Der Pfad überschreitet die vom System definierte maximale Länge.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

OperationCanceledException

Der Benutzer bricht den Vorgang ab, oder das Verzeichnis kann nicht gelöscht werden.

Beispiele

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 wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht, der Benutzer aufgefordert, den Löschvorgang zu bestätigen, aber den Inhalt nicht in den Papierkorb zu senden.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht und an den Papierkorb gesendet, der Fortschritt des Vorgangs wird jedoch nicht angezeigt.

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

Hinweise

Die Parameter showUI und recycle werden in Anwendungen, die nicht benutzeraktiv sind, wie z. B. Windows Dienste, nicht unterstützt.

Weitere Informationen

Gilt für:

DeleteDirectory(String, DeleteDirectoryOption)

Löscht ein Verzeichnis.

public:
 static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);
public static void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit
Public Shared Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)

Parameter

directory
String

Verzeichnis, das gelöscht werden soll.

onDirectoryNotEmpty
DeleteDirectoryOption

Gibt an, was geschehen soll, wenn ein zu löschenes Verzeichnis Dateien oder Verzeichnisse enthält. Der Standardwert ist DeleteDirectoryOption.DeleteAllContents.

Ausnahmen

ArgumentException

Der Pfad ist eine leere Zeichenfolge, ist falsch formatiert, enthält nur Leerzeichen oder enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden oder ist eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

Der Pfad überschreitet die vom System definierte maximale Länge.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

OperationCanceledException

Der Benutzer bricht den Vorgang ab, oder das Verzeichnis kann nicht gelöscht werden.

Beispiele

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 wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht, der Benutzer aufgefordert, den Löschvorgang zu bestätigen, aber den Inhalt nicht in den Papierkorb zu senden.

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

In diesem Beispiel wird das Verzeichnis OldDirectory und der gesamte Inhalt gelöscht und an den Papierkorb gesendet, der Fortschritt des Vorgangs wird jedoch nicht angezeigt.

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

Weitere Informationen

Gilt für: