My.Computer.FileSystem.DeleteFile 方法

更新：2007 年 11 月

删除一个文件。

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

参数

• file
  String：要删除文件的文件名和路径。必选。

• showUI
  UIOption：是否直观跟踪操作的进度。默认值为 UIOption.OnlyErrorDialogs。必选。

• recycle
  RecycleOption：是否将删除的文件放入“回收站”。默认值为 RecycleOption.DeletePermanently。必选。

• onUserCancel
  UICancelOption：指定是否在用户取消操作时引发异常。默认值为 UICancelOption.ThrowException。必选。

异常

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

• 路径由于以下原因之一而无效：它是零长度字符串；它仅包含空白；它包含无效字符；它的结尾带一个斜杠却未指定文件；或者它是一个设备路径（以 \\.\ 开头）(ArgumentException)。

• 路径无效，因为它是 Nothing (ArgumentNullException)。

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

• 路径中的文件名或目录名包含冒号 (:)，或格式无效 (NotSupportedException)。

• 文件正在使用 (IOException)。

• 该用户缺少查看该路径所必需的权限 (SecurityException)。

• 该文件不存在 (FileNotFoundException)。

• 用户没有删除文件的权限，或文件为只读 (UnauthorizedAccessException)。

• 部分信任情况，此时用户没有足够的权限 (SecurityException)。

• 用户取消操作，并且 onUserCancel 设为 UICancelOption.ThrowException (OperationCanceledException)。

备注

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

任务

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

要执行的操作	请参见
删除文件	如何：在 Visual Basic 中删除文件
删除目录中的所有文件	如何：在 Visual Basic 中删除目录中的所有文件

示例

此示例删除文件 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)

要求

命名空间：Microsoft.VisualBasic.MyServices

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

**程序集：**Visual Basic Runtime Library（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出可用性

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	是
Windows 服务	是
网站	是

权限

以下权限可能是必需的：

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联的枚举：Unrestricted。
UIPermission	控制与用户界面和剪贴板相关的权限。关联的枚举：SafeSubWindows。

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

请参见

任务

如何：在 Visual Basic 中删除目录

参考

My.Computer.FileSystem 对象

UIOption 枚举

RecycleOption 枚举

UICancelOption 枚举

FileSystem.DeleteFile

My.Computer.FileSystem 对象