FileSystem.DeleteDirectory Метод

Определение

Удаляет каталог.Deletes a directory.

Перегрузки

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Удаляет каталог.Deletes a directory.

DeleteDirectory(String, UIOption, RecycleOption)

Удаляет каталог.Deletes a directory.

DeleteDirectory(String, DeleteDirectoryOption)

Удаляет каталог.Deletes a directory.

DeleteDirectory(String, UIOption, RecycleOption, UICancelOption)

Удаляет каталог.Deletes a directory.

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

Каталог, который необходимо удалить.Directory to be deleted.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Указывает, нужно ли перемещать удаленный файл в Корзину.Specifies whether or not the deleted file should be sent to the Recycle Bin. Значение по умолчанию — RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

onUserCancel
UICancelOption

Указывает, следует ли создавать исключение, если пользователь нажимает кнопку Отмена.Specifies whether to throw an exception if the user clicks Cancel.

Исключения

Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки).The path is a zero-length string, is malformed, contains only white space, or contains invalid characters (including wildcard characters). Путь является путем к устройству (начинается с символов \\.\).The path is a device path (starts with \\.\).

Параметр directory имеет значение Nothing или является пустой строкой.directory is Nothing or an empty string.

Каталог не существует или является файлом.The directory does not exist or is a file.

Файл в каталоге или подкаталоге используется.A file in the directory or subdirectory is in use.

Имя каталога содержит двоеточие (:).The directory name contains a colon (:).

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимых разрешений.The user does not have required permissions.

Пользователь отменяет операцию, или не удается удалить каталог.The user cancels the operation or the directory cannot be deleted.

Примеры

В этом примере каталог удаляется OldDirectory только в том случае, если он пуст.The example deletes the directory OldDirectory only if it is empty.

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

В этом примере удаляется каталог OldDirectory и все его содержимое.This example deletes the directory OldDirectory and all of its contents.

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

В этом примере удаляется каталог OldDirectory и все его содержимое, запрашивающие пользователя подтвердить удаление, но не отправляющее содержимое в корзину.This example deletes the directory OldDirectory and all of its contents, asking the user to confirm the deletion, but does not send the contents to the Recycle Bin.

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

Этот пример удаляет каталог OldDirectory и все его содержимое, отправляя их в корзину, но не отображая ход выполнения операции.This example deletes the directory OldDirectory and all of its contents, sending them to the Recycle Bin, but does not show the progress of the operation.

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

Комментарии

Параметры showUI, recycleи onUserCancel не поддерживаются в приложениях, которые не являются интерактивными пользователями, такими как службы Windows.The showUI, recycle, and onUserCancel parameters are not supported in applications that are not user interactive, such as Windows Services.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

DeleteDirectory(String, UIOption, RecycleOption)

Удаляет каталог.Deletes a directory.

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

Каталог, который необходимо удалить.Directory to be deleted.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Specifies whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption

Указывает, нужно ли перемещать удаленный файл в Корзину.Specifies whether or not the deleted file should be sent to the Recycle Bin. Значение по умолчанию — RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

Исключения

Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки).The path is a zero-length string, is malformed, contains only white space, or contains invalid characters (including wildcard characters). Путь является путем к устройству (начинается с символов \\.\).The path is a device path (starts with \\.\).

Параметр directory имеет значение Nothing или является пустой строкой.directory is Nothing or an empty string.

Каталог не существует или является файлом.The directory does not exist or is a file.

Файл в каталоге или подкаталоге используется.A file in the directory or subdirectory is in use.

Имя каталога содержит двоеточие (:).The directory name contains a colon (:).

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимых разрешений.The user does not have required permissions.

Пользователь отменяет операцию, или не удается удалить каталог.The user cancels the operation or the directory cannot be deleted.

Примеры

В этом примере каталог удаляется OldDirectory только в том случае, если он пуст.The example deletes the directory OldDirectory only if it is empty.

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

В этом примере удаляется каталог OldDirectory и все его содержимое.This example deletes the directory OldDirectory and all of its contents.

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

В этом примере удаляется каталог OldDirectory и все его содержимое, запрашивающие пользователя подтвердить удаление, но не отправляющее содержимое в корзину.This example deletes the directory OldDirectory and all of its contents, asking the user to confirm the deletion, but does not send the contents to the Recycle Bin.

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

Этот пример удаляет каталог OldDirectory и все его содержимое, отправляя их в корзину, но не отображая ход выполнения операции.This example deletes the directory OldDirectory and all of its contents, sending them to the Recycle Bin, but does not show the progress of the operation.

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

Комментарии

Параметры showUI и recycle не поддерживаются в приложениях, которые не являются интерактивными пользователями, например службами Windows.The showUI and recycle parameters are not supported in applications that are not user interactive, such as Windows Services.

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

DeleteDirectory(String, DeleteDirectoryOption)

Удаляет каталог.Deletes a directory.

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

Каталог, который необходимо удалить.Directory to be deleted.

onDirectoryNotEmpty
DeleteDirectoryOption

Указывает, какие действия должны выполняться, когда удаляемый каталог содержит файлы или каталоги.Specifies what should be done when a directory that is to be deleted contains files or directories. Значение по умолчанию — DeleteDirectoryOption.DeleteAllContents.Default is DeleteDirectoryOption.DeleteAllContents.

Исключения

Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки).The path is a zero-length string, is malformed, contains only white space, or contains invalid characters (including wildcard characters). Путь является путем к устройству (начинается с символов \\.\).The path is a device path (starts with \\.\).

Параметр directory имеет значение Nothing или является пустой строкой.directory is Nothing or an empty string.

Каталог не существует или является файлом.The directory does not exist or is a file.

Файл в каталоге или подкаталоге используется.A file in the directory or subdirectory is in use.

Имя каталога содержит двоеточие (:).The directory name contains a colon (:).

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимых разрешений.The user does not have required permissions.

Пользователь отменяет операцию, или не удается удалить каталог.The user cancels the operation or the directory cannot be deleted.

Примеры

В этом примере каталог удаляется OldDirectory только в том случае, если он пуст.The example deletes the directory OldDirectory only if it is empty.

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

В этом примере удаляется каталог OldDirectory и все его содержимое.This example deletes the directory OldDirectory and all of its contents.

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

В этом примере удаляется каталог OldDirectory и все его содержимое, запрашивающие пользователя подтвердить удаление, но не отправляющее содержимое в корзину.This example deletes the directory OldDirectory and all of its contents, asking the user to confirm the deletion, but does not send the contents to the Recycle Bin.

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

Этот пример удаляет каталог OldDirectory и все его содержимое, отправляя их в корзину, но не отображая ход выполнения операции.This example deletes the directory OldDirectory and all of its contents, sending them to the Recycle Bin, but does not show the progress of the operation.

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

Безопасность

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

Применяется к