My.Computer.FileSystem.DeleteDirectory 方法

發行項
08/21/2008

更新：2007 年 11 月

刪除目錄。

 ' Usage My.Computer.FileSystem.DeleteDirectory(directory ,onDirectoryNotEmpty) My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle) My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle ,onUserCancel) ' Declaration Public Sub DeleteDirectory( _    ByVal directory As String, _    ByVal onDirectoryNotEmpty As DeleteDirectoryOption _ ) ' -or- Public Sub DeleteDirectory( _    ByVal directory As String, _    ByVal showUI As UIOption, _    ByVal recycle As RecycleOption _ ) ' -or- Public Sub DeleteDirectory( _    ByVal directory As String, _    ByVal showUI As UIOption, _    ByVal recycle As RecycleOption, _    ByVal onUserCancel As UICancelOption _ )

參數

directory
String：要刪除的目錄。必要項。
onDirectoryNotEmpty
DeleteDirectoryOption 列舉型別：指定如果要刪除的目錄包含檔案或目錄時，應該要如何處理。預設值為 DeleteDirectoryOption.DeleteAllContents。
showUI
UIOption 列舉型別：指定是否視覺化追蹤作業的進度。預設值為 UIOption.OnlyErrorDialogs。必要項。
recycle
RecycleOption 列舉型別：指定已刪除的檔案是否應該傳送至 [資源回收筒]。預設值為 RecycleOption.DeletePermanently。
onUserCancel
UICancelOption 列舉型別：指定如果使用者按一下 [取消]，是否會擲回例外狀況。必要項。

例外狀況

下列情形可能會造成例外狀況：

路徑是長度為零的字串、格式錯誤、只包含空白字元，或是包含無效的字元 (包括萬用字元 (Wildcard Character)) (ArgumentException)。
路徑是裝置路徑 (開頭為 \\.\) (ArgumentException)。
路徑是 Nothing (ArgumentNullException)。
目錄不存在，或此目錄為檔案 (DirectoryNotFoundException)。
目錄不是空的，而且 onDirectoryNotEmpty 已設為 ThrowIfDirectoryNonEmpty (IOException)。
使用者沒有刪除目錄或子目錄的使用權限 (IOException)。
目錄或子目錄中的檔案正在使用中 (IOException)。
檔案或目錄名稱含有冒號 (:) (NotSupportedException)。
使用者會取消作業，或無法刪除目錄 (OperationCanceledException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
使用者未具備必要的使用權限 (SecurityException)。

備註

不與使用者互動的應用程式 (如 Windows 服務) 不會支援 showUI、recycle 和 onUserCancel 參數。

工作

下表列出包含 My.Computer.FileSystem.DeleteDirectory 方法的工作範例。

若要	請參閱
刪除目錄	HOW TO：在 Visual Basic 中刪除目錄

範例

唯有目錄 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)

需求

命名空間 (Namespace)︰Microsoft.VisualBasic.MyServices

類別 (Class)：FileSystemProxy (提供對 FileSystem 的存取)

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	是
Windows 服務	是
網站	是

使用權限

下列使用權限可能為必要：

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。
UIPermission	控制與使用者介面和剪貼簿相關的使用權限。關聯的列舉型別：SafeSubWindows。