My.Computer.FileSystem.DeleteDirectory (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Elimina un directorio.

' Usage
My.Computer.FileSystem.DeleteDirectory(directory ,onDirectoryNotEmpty)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle)
My.Computer.FileSystem.DeleteDirectory(directory ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal onDirectoryNotEmpty As DeleteDirectoryOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteDirectory( _
   ByVal directory As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

Parámetros

directory
String. Directorio que se va a eliminar. Obligatorio.
onDirectoryNotEmpty
DeleteDirectoryOption (Enumeración) Especifica qué se debe hacer cuando un directorio que se va a borrar contiene archivos o directorios. El valor predeterminado es DeleteDirectoryOption.DeleteAllContents.
showUI
UIOption (Enumeración). Indica si se debe hacer un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs. Obligatorio.
recycle
RecycleOption (Enumeración). Especifica si el archivo debe enviarse o no a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently.
onUserCancel
UICancelOption (Enumeración). Especifica si debe producirse una excepción si el usuario hace clic en Cancelar. Obligatorio.

Excepciones

Las condiciones siguientes pueden producir una excepción:

La ruta de acceso es una cadena de longitud cero, es incorrecta, contiene sólo espacios en blanco o contiene caracteres no válidos (incluidos los caracteres comodín) (ArgumentException).
La ruta de acceso es una ruta de acceso de dispositivo (comienza con \\. \) (ArgumentException).
La ruta de acceso es Nothing (ArgumentNullException).
El directorio no existe o es un archivo (DirectoryNotFoundException).
El directorio no está vacío y el parámetro onDirectoryNotEmpty está establecido en ThrowIfDirectoryNonEmpty (IOException).
El usuario no tiene permiso para eliminar el directorio o subdirectorio (IOException).
Un archivo del directorio o subdirectorio está en uso (IOException).
Un nombre de archivo o directorio contiene dos puntos (:) (NotSupportedException).
El usuario cancela la operación o no se puede eliminar el directorio (OperationCanceledException).
La ruta supera la longitud máxima definida por el sistema (PathTooLongException).
El usuario no ha necesitado permisos (SecurityException).

Comentarios

Los parámetros showUI, recycle y onUserCancel no se admiten en aplicaciones que no interactúan con el usuario, como Servicios de Windows.

Tareas

En la tabla siguiente se muestra un ejemplo de una tarea en la que interviene el método My.Computer.FileSystem.DeleteDirectory.

Para	Vea
Eliminar un directorio	Cómo: Eliminar un directorio en Visual Basic

Ejemplo

En el ejemplo sólo se elimina el directorio OldDirectory si está vacío.

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

Este ejemplo elimina el directorio OldDirectory y todo su contenido.

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

Este ejemplo elimina el directorio OldDirectory y todo su contenido, y pide al usuario que confirme la eliminación, pero no envía el contenido a la Papelera de reciclaje.

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

Este ejemplo elimina el directorio OldDirectory y todo su contenido, y los envía a la Papelera de reciclaje, pero no muestra el progreso de la operación.

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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí

Permisos

Los permisos siguientes pueden ser necesarios:

Permiso	Descripción
FileIOPermission	Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.
UIPermission	Controla los permisos relacionados con las interfaces de usuario y el Portapapeles. Enumeración asociada: SafeSubWindows.