FileSystemProxy.DeleteFile 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

刪除檔案。

多載

DeleteFile(String)	刪除檔案。
DeleteFile(String, UIOption, RecycleOption)	刪除檔案。
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	刪除檔案。

DeleteFile(String)

刪除檔案。

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

public void DeleteFile (string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

參數

file

String

要刪除之檔案的檔名及路徑。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;其具有必須指定檔案的尾端斜線;或它是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

file 為 Nothing 或空字串。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

IOException

檔案正在使用中。

SecurityException

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

FileNotFoundException

檔案不存在。

UnauthorizedAccessException

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

範例

此範例會刪除檔案 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)

備註

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

收件者	請參閱
刪除檔案	作法：刪除檔案

另請參閱

• 物件 (Visual Basic)
• 如何：在 Visual Basic 中刪除檔案

DeleteFile(String, UIOption, RecycleOption)

刪除檔案。

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)

參數

file

String

要刪除之檔案的檔名及路徑。

showUI

UIOption

是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。

recycle

RecycleOption

是否應該將已刪除的檔案傳送至 回收站。 預設為 RecycleOption.DeletePermanently。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;其具有必須指定檔案的尾端斜線;或它是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

file 為 Nothing 或空字串。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

IOException

檔案正在使用中。

SecurityException

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

FileNotFoundException

檔案不存在。

UnauthorizedAccessException

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

範例

此範例會刪除檔案 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)

備註

showUIrecycle和參數不支援不是使用者互動式的應用程式，例如 Windows 服務。

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

收件者	請參閱
刪除檔案	作法：刪除檔案

另請參閱

• RecycleOption
• UIOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中刪除檔案

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

刪除檔案。

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)

參數

file

String

要刪除之檔案的檔名及路徑。

showUI

UIOption

是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs。

recycle

RecycleOption

是否應該將已刪除的檔案傳送至 回收站。 預設為 RecycleOption.DeletePermanently。

onUserCancel

UICancelOption

指定是否在使用者取消作業時擲回例外狀況。 預設為 UICancelOption.ThrowException。

例外狀況

ArgumentException

路徑無效，原因如下：它是零長度字串;它只包含空格符;它包含無效的字元;其具有必須指定檔案的尾端斜線;或它是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

file 為 Nothing 或空字串。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

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

IOException

檔案正在使用中。

SecurityException

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

FileNotFoundException

檔案不存在。

UnauthorizedAccessException

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

OperationCanceledException

使用者取消作業並且 onUserCancel 設為 ThrowException。

範例

此範例會刪除檔案 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)

備註

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

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

收件者	請參閱
刪除檔案	作法：刪除檔案

另請參閱

• UICancelOption
• RecycleOption
• UIOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中刪除檔案