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

Статья
11/05/2008

Обновлен: Ноябрь 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.

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

Пример

В примере удаляется каталог 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)

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

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Да
Служба Windows	Да
Веб-узел	Да

Разрешения

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

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted.
UIPermission	Определяет разрешения, относящиеся к пользовательским интерфейсам и буферу обмена. Связанное перечисление: SafeSubWindows.