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 方法的任务示例。
要执行的操作 |
请参见 |
---|---|
删除文件 |
|
删除目录中的所有文件 |
示例
此示例删除文件 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 服务 |
是 |
网站 |
是 |
权限
以下权限可能是必需的:
权限 |
说明 |
---|---|
控制访问文件和文件夹的能力。关联的枚举:Unrestricted。 |
|
控制与用户界面和剪贴板相关的权限。关联的枚举:SafeSubWindows。 |