My.Computer.FileSystem.DeleteFile-Methode

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.

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

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Löschen eines Verzeichnisses in Visual Basic

Referenz

My.Computer.FileSystem-Objekt

UIOption-Enumeration

RecycleOption-Enumeration

UICancelOption-Enumeration

FileSystem.DeleteFile

My.Computer.FileSystem-Objekt