FileSystemProxy.DeleteFile 方法

定義

命名空間:: Microsoft.VisualBasic.MyServices

組件:: Microsoft.VisualBasic.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

刪除檔案。

多載

名稱	Description
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)

備註

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

下表列出與此 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 Services。

下表列出與此 My.Computer.FileSystem.DeleteFile 方法相關的任務範例。

至	看！
刪除檔案	如何：刪除檔案

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？