FileSystem.DeleteDirectory Метод

Определение

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

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

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

Перегрузки

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)	Удаляет каталог.
DeleteDirectory(String, UIOption, RecycleOption)	Удаляет каталог.
DeleteDirectory(String, DeleteDirectoryOption)	Удаляет каталог.

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

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

FileSystem.vb

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

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

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

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

Public Shared 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

DeleteDirectory(String, UIOption, RecycleOption)

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

FileSystem.vb

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

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

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

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

Public Shared 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

DeleteDirectory(String, DeleteDirectoryOption)

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

FileSystem.vb

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

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

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

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

Public Shared 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