FileSystemProxy.DeleteDirectory Method (String, DeleteDirectoryOption)

 

Deletes a directory.

Namespace:   Microsoft.VisualBasic.MyServices
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public void DeleteDirectory(
	string directory,
	DeleteDirectoryOption onDirectoryNotEmpty
)

Parameters

directory
Type: System.String

Directory to be deleted.

onDirectoryNotEmpty
Type: Microsoft.VisualBasic.FileIO.DeleteDirectoryOption

Specifies what should be done when a directory that is to be deleted contains files or directories. Default is DeleteDirectoryOption.DeleteAllContents.

Exception Condition
ArgumentException

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 \\.\).

ArgumentNullException

directory is Nothing or an empty string.

DirectoryNotFoundException

The directory does not exist or is a file.

IOException

The directory is not empty, and onDirectoryNotEmpty is set to ThrowIfDirectoryNonEmpty.

IOException

The user does not have permission to delete the directory or subdirectory.

IOException

A file in the directory or subdirectory is in use.

NotSupportedException

The directory name contains a colon (:).

PathTooLongException

The path exceeds the system-defined maximum length.

SecurityException

The user does not have required permissions.

OperationCanceledException

The user cancels the operation or the directory cannot be deleted.

The example deletes the directory OldDirectory only if it is empty.

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

This example deletes the directory OldDirectory and all of its contents.

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

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)

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. Associated enumeration: Unrestricted.

.NET Framework
Available since 2.0
Return to top
Show: