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)

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

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)
• Практическое руководство. Удаление файла в Visual Basic

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

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

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)
• Практическое руководство. Удаление файла в Visual Basic

DeleteDirectory(String, DeleteDirectoryOption)

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

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)
• Практическое руководство. Удаление файла в Visual Basic