Метод My.Computer.FileSystem.DeleteFile

Обновлен: Ноябрь 2007

Позволяет удалить файл.

' 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).

Заметки

Параметры showUI, recycle и onUserCancel не поддерживаются в неинтерактивных приложениях, таких как службы Windows.

Задачи

В приведенной ниже таблице указаны примеры задач, в которых используется метод 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 (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Удаление каталога в Visual Basic

Ссылки

Объект My.Computer.FileSystem

Перечисление UIOption

Перечисление RecycleOption

Перечисление UICancelOption

FileSystem.DeleteFile

Объект My.Computer.FileSystem