My.Computer.FileSystem.DeleteDirectory 方法

更新：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 枚举。指定是否在用户单击“取消”时引发异常。必选。

异常

以下情况可能会导致异常：

• 路径字符串的长度为零、格式不正确、只包含空白或包含无效字符（包括通配符字符） (ArgumentException)。

• 路径是设备路径（以 \\.\ 开头）(ArgumentException)。

• 路径为 Nothing (ArgumentNullException)。

• 目录不存在或者是文件 (DirectoryNotFoundException)。

• 目录不为空，并且 onDirectoryNotEmpty 设置为 ThrowIfDirectoryNonEmpty (IOException)。

• 用户没有删除目录或子目录的权限 (IOException)。

• 目录或子目录中的文件正在使用中 (IOException)。

• 文件或目录名称包含冒号 (:) (NotSupportedException)。

• 用户取消了操作，或无法删除该目录 (OperationCanceledException)。

• 路径超过了系统定义的最大长度 (PathTooLongException)。

• 用户没有必需的权限 (SecurityException)。

备注

showUI、recycle 和 onUserCancel 参数在非用户交互式应用程序（如 Windows 服务）中不受支持。

任务

下表列出了涉及 My.Computer.FileSystem.DeleteDirectory 方法的任务的示例。

示例

此示例只有在目录 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)

要求

命名空间：Microsoft.VisualBasic.MyServices

类：FileSystemProxy（提供对 FileSystem 的访问）

**程序集：**Visual Basic 运行库（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出的可用性

权限

以下权限可能是必需的：

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：在 Visual Basic 中删除文件

如何：在 Visual Basic 中删除目录

参考

My.Computer.FileSystem 对象

UICancelOption 枚举

FileSystem.DeleteDirectory

UICancelOption

RecycleOption 枚举

DeleteDirectoryOption 枚举

UICancelOption 枚举

UIOption 枚举