FileSystemProxy.DeleteFile 方法

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.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 和 recycle 参数，例如Windows服务。

下表列出了涉及 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)

注解

非用户交互的应用程序不支持 、 和 参数。

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

收件人	请参阅
删除文件	如何：删除文件

另请参阅

• UICancelOption
• RecycleOption
• UIOption
• 对象 （Visual Basic）
• 如何：删除 Visual Basic