FileSystem.DeleteDirectory 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
刪除目錄。
多載
DeleteDirectory(String, UIOption, RecycleOption, UICancelOption) |
刪除目錄。 |
DeleteDirectory(String, UIOption, RecycleOption) |
刪除目錄。 |
DeleteDirectory(String, DeleteDirectoryOption) |
刪除目錄。 |
DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)
刪除目錄。
public:
static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared 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
指定當使用者按兩下 [ 取消] 時是否擲回例外狀況。
例外狀況
路徑是長度為零的字串、格式錯誤、只包含空白字元,或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑, (開頭為 \\.\) 。
directory
為 Nothing
或空字串。
目錄不存在,或此目錄為檔案。
目錄或子目錄中的檔案正在使用中。
目錄名稱包含冒號 (:)。
路徑超過系統定義的最大長度。
使用者未具備必要的使用權限。
使用者取消作業或無法刪除目錄。
範例
只有當目錄是空的時,此範例才會刪除目錄 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 服務。
另請參閱
適用於
DeleteDirectory(String, UIOption, RecycleOption)
刪除目錄。
public:
static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);
public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit
Public Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)
參數
- directory
- String
要刪除的目錄。
- showUI
- UIOption
指定是否要以視覺方式追蹤作業進度。 預設為 UIOption.OnlyErrorDialogs
。
- recycle
- RecycleOption
指定是否應該將已刪除的檔案傳送至 回收站。 預設為 RecycleOption.DeletePermanently
。
例外狀況
路徑是長度為零的字串、格式錯誤、只包含空白字元,或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑, (開頭為 \\.\) 。
directory
為 Nothing
或空字串。
目錄不存在,或此目錄為檔案。
目錄或子目錄中的檔案正在使用中。
目錄名稱包含冒號 (:)。
路徑超過系統定義的最大長度。
使用者未具備必要的使用權限。
使用者取消作業或無法刪除目錄。
範例
只有當目錄是空的時,此範例才會刪除目錄 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
參數,例如 Windows 服務。
另請參閱
適用於
DeleteDirectory(String, DeleteDirectoryOption)
刪除目錄。
public:
static void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);
public static void DeleteDirectory (string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);
static member DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit
Public Shared Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)
參數
- directory
- String
要刪除的目錄。
- onDirectoryNotEmpty
- DeleteDirectoryOption
指定如果要刪除的目錄內包含檔案或目錄時,應該要如何處理。 預設為 DeleteDirectoryOption.DeleteAllContents
。
例外狀況
路徑是長度為零的字串、格式錯誤、只包含空白字元,或是包含無效的字元 (包括萬用字元 (Wildcard Character))。 路徑是裝置路徑, (開頭為 \\.\) 。
directory
為 Nothing
或空字串。
目錄不存在,或此目錄為檔案。
目錄或子目錄中的檔案正在使用中。
目錄名稱包含冒號 (:)。
路徑超過系統定義的最大長度。
使用者未具備必要的使用權限。
使用者取消作業或無法刪除目錄。
範例
只有當目錄是空的時,此範例才會刪除目錄 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)