FileSystem.DeleteFile 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

刪除檔案。

多載

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

DeleteFile(String)

來源:

FileSystem.vb

刪除檔案。

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

public static void DeleteFile (string file);

static member DeleteFile : string -> unit

Public Shared 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 中刪除檔案

DeleteFile(String, UIOption, RecycleOption)

來源:

FileSystem.vb

刪除檔案。

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Shared 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)

備註

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

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

收件者	請參閱
刪除檔案	如何：在 Visual Basic 中刪除檔案

另請參閱

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

來源:

FileSystem.vb

刪除檔案。

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared 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 方法的工作範例。

收件者	請參閱
刪除檔案	如何：在 Visual Basic 中刪除檔案

另請參閱

• UICancelOption
• RecycleOption
• UIOption