FileSystemProxy.DeleteDirectory Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

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

Перегрузки

Имя	Описание
DeleteDirectory(String, UIOption, RecycleOption)	Удаляет каталог.
DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	Удаляет каталог.
DeleteDirectory(String, DeleteDirectoryOption)	Удаляет каталог.

DeleteDirectory(String, UIOption, RecycleOption)

Исходный код:

FileSystemProxy.vb

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

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)

Параметры

directory

String

Каталог для удаления.

showUI

UIOption

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

recycle

RecycleOption

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

Исключения

ArgumentException

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

ArgumentNullException

directory имеет Nothing или пустую строку.

DirectoryNotFoundException

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

IOException

Используется файл в каталоге или подкаталоге.

NotSupportedException

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

PathTooLongException

Путь превышает заданную системой максимальную длину.

SecurityException

У пользователя нет необходимых разрешений.

OperationCanceledException

Пользователь отменяет операцию или каталог не может быть удален.

Примеры

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

Комментарии

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

См. также раздел

• RecycleOption
• UIOption
• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Исходный код:

FileSystemProxy.vb

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

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Параметры

directory

String

Каталог для удаления.

showUI

UIOption

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

recycle

RecycleOption

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

onUserCancel

UICancelOption

Указывает, следует ли вызывать исключение, если пользователь нажимает кнопку "Отмена".

Исключения

ArgumentException

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

ArgumentNullException

directory имеет Nothing или пустую строку.

DirectoryNotFoundException

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

IOException

Используется файл в каталоге или подкаталоге.

NotSupportedException

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

PathTooLongException

Путь превышает заданную системой максимальную длину.

SecurityException

У пользователя нет необходимых разрешений.

OperationCanceledException

Пользователь отменяет операцию или каталог не может быть удален.

Примеры

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

Комментарии

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

См. также раздел

• UICancelOption
• RecycleOption
• UIOption
• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic

DeleteDirectory(String, DeleteDirectoryOption)

Исходный код:

FileSystemProxy.vb

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

public:
 void DeleteDirectory(System::String ^ directory, Microsoft::VisualBasic::FileIO::DeleteDirectoryOption onDirectoryNotEmpty);

public void DeleteDirectory(string directory, Microsoft.VisualBasic.FileIO.DeleteDirectoryOption onDirectoryNotEmpty);

member this.DeleteDirectory : string * Microsoft.VisualBasic.FileIO.DeleteDirectoryOption -> unit

Public Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)

Параметры

directory

String

Каталог для удаления.

onDirectoryNotEmpty

DeleteDirectoryOption

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

Исключения

ArgumentException

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

ArgumentNullException

directory имеет Nothing или пустую строку.

DirectoryNotFoundException

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

IOException

Используется файл в каталоге или подкаталоге.

NotSupportedException

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

PathTooLongException

Путь превышает заданную системой максимальную длину.

SecurityException

У пользователя нет необходимых разрешений.

OperationCanceledException

Пользователь отменяет операцию или каталог не может быть удален.

Примеры

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

См. также раздел

• DeleteDirectoryOption
• Объекты (Visual Basic)
• How to: Delete a File in Visual Basic