Freigeben über


FileSystemProxy.DeleteFile Methode

Definition

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:
 void DeleteFile(System::String ^ file);
public void DeleteFile (string file);
member this.DeleteFile : string -> unit
Public Sub DeleteFile (file As String)

Parameter

file
String

Name und Pfad der zu löschenden Datei.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; es hat einen nachgestellten Schrägstrich, in dem eine Datei angegeben werden muss; oder es ist ein Gerätepfad (beginnt mit \\.\).

Der file ist Nothing oder eine leere Zeichenfolge.

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

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

Die Datei wird gegenwärtig verwendet.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Die Datei ist nicht vorhanden.

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 sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.DeleteFile -Methode betreffen.

Beschreibung Siehe
So löschen Sie eine Datei Vorgehensweise: Löschen einer Datei

Weitere Informationen

Gilt für:

DeleteFile(String, UIOption, RecycleOption)

Löscht eine Datei.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);
public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);
member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit
Public 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

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; es hat einen nachgestellten Schrägstrich, in dem eine Datei angegeben werden muss; oder es ist ein Gerätepfad (beginnt mit \\.\).

Der file ist Nothing oder eine leere Zeichenfolge.

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

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

Die Datei wird gegenwärtig verwendet.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Die Datei ist nicht vorhanden.

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

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.DeleteFile -Methode betreffen.

Beschreibung Siehe
So löschen Sie eine Datei Vorgehensweise: Löschen einer Datei

Weitere Informationen

Gilt für:

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Löscht eine Datei.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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

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

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; es hat einen nachgestellten Schrägstrich, in dem eine Datei angegeben werden muss; oder es ist ein Gerätepfad (beginnt mit \\.\).

Der file ist Nothing oder eine leere Zeichenfolge.

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

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

Die Datei wird gegenwärtig verwendet.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Die Datei ist nicht vorhanden.

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

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 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

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

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.DeleteFile -Methode betreffen.

Beschreibung Siehe
So löschen Sie eine Datei Vorgehensweise: Löschen einer Datei

Weitere Informationen

Gilt für: