FileSystem.DeleteDirectory Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Löscht ein Verzeichnis.

Überlädt

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	Löscht ein Verzeichnis.
DeleteDirectory(String, UIOption, RecycleOption)	Löscht ein Verzeichnis.
DeleteDirectory(String, DeleteDirectoryOption)	Löscht ein Verzeichnis.

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Quelle:

FileSystem.vb

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

Das zu löschende Verzeichnis.

showUI

UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt 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 aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0, der Pfad ist falsch formatiert, er enthält nur Leerzeichen oder er enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden, oder es handelt sich um eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird gegenwärtig verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

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

SecurityException

Der Benutzer verfügt nicht über die erforderlichen 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 werden 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, wobei der Benutzer aufgefordert wird, den Löschvorgang zu bestätigen, der Inhalt wird jedoch nicht an den Papierkorb gesendet.

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

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

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

Hinweise

Die showUIParameter , recycleund onUserCancel werden nicht in Anwendungen unterstützt, die nicht interaktiv sind, z. B. Windows-Dienste.

Weitere Informationen

• UICancelOption
• RecycleOption
• UIOption

DeleteDirectory(String, UIOption, RecycleOption)

Quelle:

FileSystem.vb

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

Das zu löschende Verzeichnis.

showUI

UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt 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 aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0, der Pfad ist falsch formatiert, er enthält nur Leerzeichen oder er enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden, oder es handelt sich um eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird gegenwärtig verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

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

SecurityException

Der Benutzer verfügt nicht über die erforderlichen 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 werden 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, wobei der Benutzer aufgefordert wird, den Löschvorgang zu bestätigen, der Inhalt wird jedoch nicht an den Papierkorb gesendet.

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

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

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

Hinweise

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

Weitere Informationen

• RecycleOption
• UIOption

DeleteDirectory(String, DeleteDirectoryOption)

Quelle:

FileSystem.vb

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

Das zu löschende Verzeichnis.

onDirectoryNotEmpty

DeleteDirectoryOption

Gibt an, was geschehen soll, wenn ein Verzeichnis, das gelöscht werden soll, Dateien oder Verzeichnisse enthält. Der Standardwert ist DeleteDirectoryOption.DeleteAllContents.

Ausnahmen

ArgumentException

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0, der Pfad ist falsch formatiert, er enthält nur Leerzeichen oder er enthält ungültige Zeichen (einschließlich Platzhalterzeichen). Der Pfad ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Verzeichnis ist nicht vorhanden, oder es handelt sich um eine Datei.

IOException

Eine Datei im Verzeichnis oder Unterverzeichnis wird gegenwärtig verwendet.

NotSupportedException

Der Verzeichnisname enthält einen Doppelpunkt (:).

PathTooLongException

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

SecurityException

Der Benutzer verfügt nicht über die erforderlichen 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 werden 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, wobei der Benutzer aufgefordert wird, den Löschvorgang zu bestätigen, der Inhalt wird jedoch nicht an den Papierkorb gesendet.

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

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

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

Weitere Informationen

• DeleteDirectoryOption