FileSystem.DeleteFile 方法

定义

命名空间:

Microsoft.VisualBasic.FileIO

程序集:

Microsoft.VisualBasic.Core.dll

删除文件。

重载

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

DeleteFile(String)

Source:

FileSystem.vb

删除文件。

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

public static void DeleteFile (string file);

static member DeleteFile : string -> unit

Public Shared 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 中删除文件

DeleteFile(String, UIOption, RecycleOption)

Source:

FileSystem.vb

删除文件。

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

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

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

Public Shared 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 方法的任务示例。

功能	查看
删除文件	如何：在 Visual Basic 中删除文件

另请参阅

• RecycleOption
• UIOption

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Source:

FileSystem.vb

删除文件。

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

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

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

Public Shared 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 方法的任务示例。

功能	查看
删除文件	如何：在 Visual Basic 中删除文件

另请参阅

• UICancelOption
• RecycleOption
• UIOption