FileSystem.DeleteFile 方法

定義

命名空間:
Microsoft.VisualBasic.FileIO
組件:
Microsoft.VisualBasic.dll

刪除檔案。

多載

DeleteFile(String)

刪除檔案。

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)

刪除檔案。

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 Services。

下表列出一個涉及此 My.Computer.FileSystem.DeleteFile 方法的任務範例。

至 看！
刪除檔案 如何：在 Visual Basic

另請參閱

適用於

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

刪除檔案。

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 Services。

下表列出一個涉及此 My.Computer.FileSystem.DeleteFile 方法的任務範例。

至 看！
刪除檔案 如何：在 Visual Basic

另請參閱

適用於