FileSystem.DeleteDirectory Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет каталог.
| DeleteDirectory(String, UIOption, RecycleOption, UICancelOption) |
Удаляет каталог. |
| DeleteDirectory(String, UIOption, RecycleOption) |
Удаляет каталог. |
| DeleteDirectory(String, DeleteDirectoryOption) |
Удаляет каталог. |
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- 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 -> unitPublic 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
Указывает, следует ли создавать исключение, если пользователь нажимает кнопку Отмена.
Исключения
Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки). Путь — это путь к устройству (начинается с \\.\).
Параметр directory имеет значение Nothing или является пустой строкой.
Каталог не существует или является файлом.
Файл в каталоге или подкаталоге используется.
Имя каталога содержит двоеточие (:).
Длина пути превышает максимальную длину, определенную в системе.
Пользователь не имеет необходимых разрешений.
Пользователь отменяет операцию, или не удается удалить каталог.
Примеры
В этом примере каталог 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.
См. также раздел
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- 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 -> unitPublic Shared Sub DeleteDirectory (directory As String, showUI As UIOption, recycle As RecycleOption)Параметры
- directory
- String
Каталог, который необходимо удалить.
- showUI
- UIOption
Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs.
- recycle
- RecycleOption
Указывает, следует ли отправлять удаленный файл в корзину. Значение по умолчанию — RecycleOption.DeletePermanently.
Исключения
Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки). Путь — это путь к устройству (начинается с \\.\).
Параметр directory имеет значение Nothing или является пустой строкой.
Каталог не существует или является файлом.
Файл в каталоге или подкаталоге используется.
Имя каталога содержит двоеточие (:).
Длина пути превышает максимальную длину, определенную в системе.
Пользователь не имеет необходимых разрешений.
Пользователь отменяет операцию, или не удается удалить каталог.
Примеры
В этом примере каталог 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.
См. также раздел
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Исходный код:
- FileSystem.vb
- Исходный код:
- FileSystem.vb
- Исходный код:
- 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 -> unitPublic Shared Sub DeleteDirectory (directory As String, onDirectoryNotEmpty As DeleteDirectoryOption)Параметры
- directory
- String
Каталог, который необходимо удалить.
- onDirectoryNotEmpty
- DeleteDirectoryOption
Указывает, какие действия должны выполняться, когда удаляемый каталог содержит файлы или каталоги. Значение по умолчанию — DeleteDirectoryOption.DeleteAllContents.
Исключения
Путь является пустой строкой, некорректен, содержит только пробелы или содержит недопустимые символы (включая знаки подстановки). Путь — это путь к устройству (начинается с \\.\).
Параметр directory имеет значение Nothing или является пустой строкой.
Каталог не существует или является файлом.
Файл в каталоге или подкаталоге используется.
Имя каталога содержит двоеточие (:).
Длина пути превышает максимальную длину, определенную в системе.
Пользователь не имеет необходимых разрешений.
Пользователь отменяет операцию, или не удается удалить каталог.
Примеры
В этом примере каталог 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)
См. также раздел
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: