Freigeben über


FileSystemProxy.DeleteDirectory Methode

Definition

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

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 \\.\).

Der directory ist Nothing oder eine leere Zeichenfolge.

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

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

Der Verzeichnisname enthält einen Doppelpunkt (:).

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

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

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

Gilt für:

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

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 \\.\).

Der directory ist Nothing oder eine leere Zeichenfolge.

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

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

Der Verzeichnisname enthält einen Doppelpunkt (:).

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

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

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

Gilt für:

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

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 \\.\).

Der directory ist Nothing oder eine leere Zeichenfolge.

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

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

Der Verzeichnisname enthält einen Doppelpunkt (:).

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

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

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

Gilt für: