FileSystemProxy.DeleteDirectory Methode

Definition

Namespace:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Löscht ein Verzeichnis.

Überlädt

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

DeleteDirectory(String, UIOption, RecycleOption)

Löscht ein Verzeichnis.

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public 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
• Objekte (Visual Basic)
• Gewusst wie: Löschen einer Datei in Visual Basic

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Löscht ein Verzeichnis.

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public 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
• Objekte (Visual Basic)
• Gewusst wie: Löschen einer Datei in Visual Basic

DeleteDirectory(String, DeleteDirectoryOption)

Löscht ein Verzeichnis.

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit

Public 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
• Objekte (Visual Basic)
• Gewusst wie: Löschen einer Datei in Visual Basic