FileSystemProxy.DeleteFile 方法

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.Forms.dll

删除文件。

重载

DeleteFile(String)	删除文件。
DeleteFile(String, UIOption, RecycleOption)	删除文件。
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	删除文件。

DeleteFile(String)

删除文件。

public:
 void DeleteFile(System::String ^ file);

public void DeleteFile (string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

参数

file

String

要删除的文件的名称和路径。

例外

ArgumentException

路径无效，原因如下：它是零长度字符串;它仅包含空格;它包含无效字符;它具有尾部斜杠，其中必须指定文件;或它是以 \\.\) 开头 (设备路径。

ArgumentNullException

file 为 Nothing 或空字符串。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

IOException

该文件正在使用。

SecurityException

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

FileNotFoundException

文件不存在。

UnauthorizedAccessException

该用户没有删除该文件的权限，或者该文件为只读。

示例

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

注解

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

功能	查看
删除文件	如何：删除文件

另请参阅

• 对象 (Visual Basic)
• 如何：在 Visual Basic 中删除文件

DeleteFile(String, UIOption, RecycleOption)

删除文件。

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

参数

file

String

要删除的文件的名称和路径。

showUI

UIOption

是否对操作进度进行可视跟踪。 默认值为 UIOption.OnlyErrorDialogs。

recycle

RecycleOption

删除的文件是否应发送到“回收站”。 默认值为 RecycleOption.DeletePermanently。

例外

ArgumentException

路径无效，原因如下：它是零长度字符串;它仅包含空格;它包含无效字符;它具有尾部斜杠，其中必须指定文件;或它是以 \\.\) 开头 (设备路径。

ArgumentNullException

file 为 Nothing 或空字符串。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

IOException

该文件正在使用。

SecurityException

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

FileNotFoundException

文件不存在。

UnauthorizedAccessException

该用户没有删除该文件的权限，或者该文件为只读。

示例

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

注解

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

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

功能	查看
删除文件	如何：删除文件

另请参阅

• RecycleOption
• UIOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中删除文件

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

删除文件。

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

参数

file

String

要删除的文件的名称和路径。

showUI

UIOption

是否对操作进度进行可视跟踪。 默认值为 UIOption.OnlyErrorDialogs。

recycle

RecycleOption

删除的文件是否应发送到“回收站”。 默认值为 RecycleOption.DeletePermanently。

onUserCancel

UICancelOption

指定用户取消操作时是否引发异常。 默认值为 UICancelOption.ThrowException。

例外

ArgumentException

路径无效，原因如下：它是零长度字符串;它仅包含空格;它包含无效字符;它具有尾部斜杠，其中必须指定文件;或它是以 \\.\) 开头 (设备路径。

ArgumentNullException

file 为 Nothing 或空字符串。

PathTooLongException

路径超过了系统定义的最大长度。

NotSupportedException

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

IOException

该文件正在使用。

SecurityException

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

FileNotFoundException

文件不存在。

UnauthorizedAccessException

该用户没有删除该文件的权限，或者该文件为只读。

OperationCanceledException

用户已取消该操作并且 onUserCancel 已设置为 ThrowException。

示例

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

注解

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

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

功能	查看
删除文件	如何：删除文件

另请参阅

• UICancelOption
• RecycleOption
• UIOption
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中删除文件