My.Computer.FileSystem.DeleteFile-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Löscht eine Datei.

' Usage
My.Computer.FileSystem.DeleteFile(file)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteFile( _
   ByVal file As String _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parameter

file
String. Name und Pfad der zu löschenden Datei. Erforderlich.
showUI
UIOption. Ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs. Erforderlich.
recycle
RecycleOption. Ob die gelöschte Datei in den Papierkorb verschoben werden soll. Der Standardwert ist RecycleOption.DeletePermanently. Erforderlich.
onUserCancel
UICancelOption. Gibt an, ob eine Ausnahme ausgelöst wird, wenn der Benutzer den Vorgang abbricht. Der Standardwert ist UICancelOption.ThrowException. Erforderlich.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, einen nachgestellten Schrägstrich, nach dem eine Datei angegeben werden muss, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Die Datei wird gegenwärtig verwendet (IOException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Die Datei ist nicht vorhanden (FileNotFoundException).
Der Benutzer verfügt über keine Berechtigung zum Löschen der Datei, oder die Datei ist schreibgeschützt (UnauthorizedAccessException).
Ein teilweise vertrauenswürdiger Kontext, in dem der Benutzer nicht über ausreichende Berechtigungen verfügt (SecurityException).
Der Benutzer hat den Vorgang abgebrochen, und onUserCancel ist auf UICancelOption.ThrowException festgelegt (OperationCanceledException).

Hinweise

Der showUI-Parameter, der recycle-Parameter und der onUserCancel-Parameter werden in Anwendungen nicht unterstützt, die keinen interaktiven Modus aufweisen, z. B. in Windows-Diensten.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.DeleteFile-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Löschen einer Datei	Gewusst wie: Löschen einer Datei in Visual Basic
Löschen aller Dateien in einem Verzeichnis	Gewusst wie: Löschen aller Dateien in einem Verzeichnis in Visual Basic

Beispiel

In diesem Beispiel wird die Datei Test.txt gelö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 in den Papierkorb verschoben.

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

Anforderungen

Namespace: Microsoft.VisualBasic.MyServices

Klasse: FileSystemProxy (ermöglicht den Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows.