FileSystemProxy.DeleteDirectory 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

刪除目錄。

多載

DeleteDirectory(String, UIOption, RecycleOption)	刪除目錄。
DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	刪除目錄。
DeleteDirectory(String, DeleteDirectoryOption)	刪除目錄。

DeleteDirectory(String, UIOption, RecycleOption)

刪除目錄。

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)

參數

directory

String

要刪除的目錄。

showUI

UIOption

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

recycle

RecycleOption

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

例外狀況

ArgumentException

路徑是長度為零的字串、格式錯誤、只包含空白字元，或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

directory 為 Nothing 或空字串。

DirectoryNotFoundException

目錄不存在，或此目錄為檔案。

IOException

目錄或子目錄中的檔案正在使用中。

NotSupportedException

目錄名稱包含冒號 (:)。

PathTooLongException

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

SecurityException

使用者未具備必要的使用權限。

OperationCanceledException

使用者取消作業或無法刪除目錄。

範例

只有當目錄是空的時，此範例才會刪除目錄 OldDirectory 。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

本範例會刪除目錄 OldDirectory 及其所有內容。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.DeleteAllContents)

本範例會刪除目錄 OldDirectory 及其所有內容，要求使用者確認刪除，但不會將內容傳送至 回收站。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.DeletePermanently,
  FileIO.UICancelOption.ThrowException)

本範例會刪除目錄 OldDirectory 及其所有內容，並將其傳送至 回收站，但不會顯示作業的進度。

My.Computer.FileSystem.DeleteDirectory(
 "C:\OldDirectory",
 FileIO.UIOption.AllDialogs,
 FileIO.RecycleOption.SendToRecycleBin,
 FileIO.UICancelOption.ThrowException)

備註

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

另請參閱

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

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

刪除目錄。

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

參數

directory

String

要刪除的目錄。

showUI

UIOption

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

recycle

RecycleOption

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

onUserCancel

UICancelOption

指定如果使用者按兩下 [ 取消] 時是否擲回例外狀況。

例外狀況

ArgumentException

路徑是長度為零的字串、格式錯誤、只包含空白字元，或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

directory 為 Nothing 或空字串。

DirectoryNotFoundException

目錄不存在，或此目錄為檔案。

IOException

目錄或子目錄中的檔案正在使用中。

NotSupportedException

目錄名稱包含冒號 (:)。

PathTooLongException

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

SecurityException

使用者未具備必要的使用權限。

OperationCanceledException

使用者取消作業或無法刪除目錄。

範例

只有當目錄是空的時，此範例才會刪除目錄 OldDirectory 。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

本範例會刪除目錄 OldDirectory 及其所有內容。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.DeleteAllContents)

本範例會刪除目錄 OldDirectory 及其所有內容，要求使用者確認刪除，但不會將內容傳送至 回收站。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.DeletePermanently,
  FileIO.UICancelOption.ThrowException)

本範例會刪除目錄 OldDirectory 及其所有內容，並將其傳送至 回收站，但不會顯示作業的進度。

My.Computer.FileSystem.DeleteDirectory(
 "C:\OldDirectory",
 FileIO.UIOption.AllDialogs,
 FileIO.RecycleOption.SendToRecycleBin,
 FileIO.UICancelOption.ThrowException)

備註

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

另請參閱

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

DeleteDirectory(String, DeleteDirectoryOption)

刪除目錄。

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);

public void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit

Public Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)

參數

directory

String

要刪除的目錄。

onDirectoryNotEmpty

DeleteDirectoryOption

指定如果要刪除的目錄內包含檔案或目錄時，應該要如何處理。 預設為 DeleteDirectoryOption.DeleteAllContents。

例外狀況

ArgumentException

路徑是長度為零的字串、格式錯誤、只包含空白字元，或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑， (開頭為 \\.\) 。

ArgumentNullException

directory 為 Nothing 或空字串。

DirectoryNotFoundException

目錄不存在，或此目錄為檔案。

IOException

目錄或子目錄中的檔案正在使用中。

NotSupportedException

目錄名稱包含冒號 (:)。

PathTooLongException

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

SecurityException

使用者未具備必要的使用權限。

OperationCanceledException

使用者取消作業或無法刪除目錄。

範例

只有當目錄是空的時，此範例才會刪除目錄 OldDirectory 。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

本範例會刪除目錄 OldDirectory 及其所有內容。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.DeleteDirectoryOption.DeleteAllContents)

本範例會刪除目錄 OldDirectory 及其所有內容，要求使用者確認刪除，但不會將內容傳送至 回收站。

My.Computer.FileSystem.DeleteDirectory(
  "C:\OldDirectory",
  FileIO.UIOption.AllDialogs,
  FileIO.RecycleOption.DeletePermanently,
  FileIO.UICancelOption.ThrowException)

本範例會刪除目錄 OldDirectory 及其所有內容，並將其傳送至 回收站，但不會顯示作業的進度。

My.Computer.FileSystem.DeleteDirectory(
 "C:\OldDirectory",
 FileIO.UIOption.AllDialogs,
 FileIO.RecycleOption.SendToRecycleBin,
 FileIO.UICancelOption.ThrowException)

另請參閱

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