My.Computer.FileSystem.DeleteFile 方法

更新：2007 年 11 月

刪除檔案。

 ' 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 _ )

參數

• file
  String。要刪除之檔案的名稱與路徑。必要項。

• showUI
  UIOption。是否要視覺化追蹤作業的進度。預設值為 UIOption.OnlyErrorDialogs。必要項。

• recycle
  RecycleOption。是否應該將刪除的檔案傳送到 [資源回收筒]。預設值為 RecycleOption.DeletePermanently。必要項。

• onUserCancel
  UICancelOption：指定當使用者取消作業時，是否擲回例外狀況。預設值為 UICancelOption.ThrowException。必要項。

例外狀況

下列情形可能會造成例外狀況：

• 因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元、它在必須指定檔案的地方含有結尾的斜線，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。

• 路徑無效，因為它是 Nothing (ArgumentNullException)。

• 路徑超過系統定義的最大長度 (PathTooLongException)。

• 路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。

• 檔案正在使用中 (IOException)。

• 使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。

• 檔案不存在 (FileNotFoundException)。

• 使用者沒有刪除檔案的使用權限，或者檔案是唯讀的 (UnauthorizedAccessException)。

• 發生使用者權限不足的部分信任狀況 (SecurityException)。

• 使用者取消作業並且 onUserCancel 設為 UICancelOption.ThrowException (OperationCanceledException)。

備註

在不是使用者互動的應用程式中 (例如，Windows 服務) 不支援 showUI、recycle 與 onUserCancel 參數。

工作

下表列出包含 My.Computer.FileSystem.DeleteFile 方法的工作範例。

若要	請參閱
若要刪除檔案	HOW TO：在 Visual Basic 中刪除檔案
若要刪除目錄中的所有檔案	HOW TO：在 Visual Basic 中刪除某一目錄內的所有檔案

範例

這個範例將刪除 Test.txt 檔案。

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

此範例將刪除 Test.txt 檔案，並讓使用者確認是否應該刪除此檔案。

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

此範例會刪除 Test.txt 檔案，並將它傳送到 [資源回收筒]。

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

需求

命名空間：Microsoft.VisualBasic.MyServices

類別：FileSystemProxy (提供對 FileSystem 的存取)

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	是
Windows 服務	是
網站	是

使用權限

下列使用權限可能為必要：

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。
UIPermission	控制與使用者介面和剪貼簿相關的使用權限。關聯的列舉型別：SafeSubWindows。

如需詳細資訊，請參閱程式碼存取安全性和要求使用權限。

請參閱

工作

HOW TO：在 Visual Basic 中刪除目錄

參考

My.Computer.FileSystem 物件

UIOption 列舉型別

RecycleOption 列舉型別

UICancelOption 列舉型別

FileSystem.DeleteFile

My.Computer.FileSystem 物件