FileSystem.DeleteFile Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Löscht eine Datei.

Überlädt

DeleteFile(String)	Löscht eine Datei.
DeleteFile(String, UIOption, RecycleOption)	Löscht eine Datei.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Löscht eine Datei.

DeleteFile(String)

Löscht eine Datei.

public:
 static void DeleteFile(System::String ^ file);

public static void DeleteFile (string file);

static member DeleteFile : string -> unit

Public Shared Sub DeleteFile (file As String)

Parameter

file: String

Name und Pfad der zu löschenden Datei.

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 enthält nur Leerräume; er enthält ungültige Zeichen; er weist an der Position, an der eine Datei angegeben werden muss, einen abschließenden Schrägstrich auf; es handelt sich um einen Gerätepfad (beginnt mit \\.\).

ArgumentNullException

Der file ist Nothing oder eine leere Zeichenfolge.

PathTooLongException

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

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

IOException

Die Datei wird gegenwärtig verwendet.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

FileNotFoundException

Die Datei ist nicht vorhanden.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung zum Löschen der Datei, oder die Datei ist schreibgeschützt.

Beispiele

In diesem Beispiel wird die Datei Test.txtgelöscht.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

In diesem Beispiel wird die Datei Test.txt gelöscht und der Benutzer kann bestätigen, dass die Datei gelöscht werden soll.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

In diesem Beispiel wird die Datei Test.txt gelöscht und an den Papierkorb gesendet.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Hinweise

In der folgenden Tabelle wird ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.DeleteFile Methode aufgeführt.

Beschreibung	Siehe
So löschen Sie eine Datei	Gewusst wie: Löschen einer Datei in Visual Basic

Gilt für

DeleteFile(String, UIOption, RecycleOption)

Löscht eine Datei.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

Parameter

file: String

Name und Pfad der zu löschenden Datei.

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

ArgumentNullException

Der file ist Nothing oder eine leere Zeichenfolge.

PathTooLongException

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

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

IOException

Die Datei wird gegenwärtig verwendet.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

FileNotFoundException

Die Datei ist nicht vorhanden.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung zum Löschen der Datei, oder die Datei ist schreibgeschützt.

Beispiele

In diesem Beispiel wird die Datei Test.txtgelöscht.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

In diesem Beispiel wird die Datei gelöscht und es dem Benutzer ermöglicht, zu bestätigen, dass die Datei Test.txt gelöscht werden soll.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

In diesem Beispiel wird die Datei Test.txt gelöscht und an den Papierkorb gesendet.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Hinweise

Die showUI parameter recycle werden in Anwendungen, die nicht benutzeraktiv sind, wie z. B. Windows Services, nicht unterstützt.

In der folgenden Tabelle wird ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.DeleteFile Methode umfasst.

Beschreibung	Siehe
So löschen Sie eine Datei	Gewusst wie: Löschen einer Datei in Visual Basic

Siehe auch

Gilt für

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Löscht eine Datei.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parameter

file: String

Name und Pfad der zu löschenden Datei.

showUI: UIOption

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

recycle: RecycleOption

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 wird, wenn der Benutzer den Vorgang abbricht. Der Standardwert ist UICancelOption.ThrowException.

Ausnahmen

ArgumentException

ArgumentNullException

Der file ist Nothing oder eine leere Zeichenfolge.

PathTooLongException

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

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

IOException

Die Datei wird gegenwärtig verwendet.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

FileNotFoundException

Die Datei ist nicht vorhanden.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung zum Löschen der Datei, oder die Datei ist schreibgeschützt.

OperationCanceledException

Der Benutzer hat den Vorgang abgebrochen, und onUserCancel ist auf ThrowException festgelegt.

Beispiele

In diesem Beispiel wird die Datei Test.txtgelöscht.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

In diesem Beispiel wird die Datei gelöscht und es dem Benutzer ermöglicht, zu bestätigen, dass die Datei Test.txt gelöscht werden soll.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

In diesem Beispiel wird die Datei Test.txt gelöscht und an den Papierkorb gesendet.

My.Computer.FileSystem.DeleteFile(
  "C:\test.txt",
  FileIO.UIOption.OnlyErrorDialogs,
  FileIO.RecycleOption.SendToRecycleBin,
  FileIO.UICancelOption.ThrowException)

Hinweise

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

In der folgenden Tabelle wird ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.DeleteFile Methode umfasst.

Beschreibung	Siehe
So löschen Sie eine Datei	Gewusst wie: Löschen einer Datei in Visual Basic

Siehe auch

Gilt für

FileSystem.DeleteFile Methode

Definition

Überlädt

DeleteFile(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für

DeleteFile(String, UIOption, RecycleOption)

Parameter

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Parameter

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

Zusätzliche Ressourcen