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

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

Удаляет каталог.

' Usage
My.Computer.FileSystem.DeleteDirectory(directory ,onDirectoryNotEmpty)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal onDirectoryNotEmpty As DeleteDirectoryOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Параметры

• directory
  String. Каталог, который необходимо удалить. Обязательный атрибут.

• onDirectoryNotEmpty
  Перечисление DeleteDirectoryOption. Указывает, какие действия должны выполняться, когда удаляемый каталог содержит файлы или каталоги. По умолчанию используется значение DeleteDirectoryOption.DeleteAllContents.

• showUI
  Перечисление UIOption. Указывает, следует ли отображать ход выполнения операции. По умолчанию используется значение UIOption.OnlyErrorDialogs. Обязательный атрибут.

• recycle
  Перечисление RecycleOption. Указывает, нужно ли удаленный файл перемещать в Корзину. По умолчанию используется значение RecycleOption.DeletePermanently.

• onUserCancel
  Перечисление UICancelOption. Указывает, будет ли выдаваться исключение, если пользователь нажмет кнопку Отмена. Обязательный атрибут.

Исключения

Возникновение исключения возможно при следующих условиях:

• Путь является строкой нулевой длины, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки) (ArgumentException).

• Путем является путь устройства (начинается с \\.\) (ArgumentException).

• Путь равен Nothing (ArgumentNullException).

• Каталог не существует или является файлом (DirectoryNotFoundException).

• Каталог не пуст и onDirectoryNotEmpty равен ThrowIfDirectoryNonEmpty (IOException).

• Пользователь не имеет разрешения на удаление каталога или подкаталога (IOException).

• Файл в каталоге или подкаталоге используется (IOException).

• Имя файла или каталога содержит двоеточие (:) (NotSupportedException).

• Пользователь отменяет операцию или каталог не удается удалить (OperationCanceledException).

• Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

• Пользователь не имеет необходимого разрешения (SecurityException).

Заметки

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

Задачи

В следующей таблице содержится пример задачи, в которой используется метод My.Computer.FileSystem.DeleteDirectory.

Пример

В примере удаляется каталог OldDirectory только в том случае, если он пуст.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

В этом примере удаляется каталог OldDirectory и все его содержимое.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.DeleteAllContents)

В этом примере удаляется каталог OldDirectory и все его содержимое, у пользователя запрашивается подтверждение удаления, но содержимое не отправляется в Корзину.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.DeletePermanently, FileIO.UICancelOption.ThrowException)

В этом примере удаляется каталог OldDirectory и все его содержимое путем помещения в Корзину, но не отображается ход выполнения операции.

My.Computer.FileSystem.DeleteDirectory("C:\OldDirectory", _
 FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:FileSystemProxy (предоставляет доступ к FileSystem)

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

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

Разрешения

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

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

См. также

Задачи

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

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

Ссылки

Объект My.Computer.FileSystem

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

FileSystem.DeleteDirectory

UICancelOption

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

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

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

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