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

Artículo
08/23/2008

Actualización: noviembre 2007

Elimina un archivo.

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

Parámetros

file
String. Nombre y ruta de acceso del archivo que se va a eliminar. Obligatorio.
showUI
UIOption. Indica si se debe hacer un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs. Obligatorio.
recycle
RecycleOption. Especifica si se debe enviar o no el archivo eliminado a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently. Obligatorio.
onUserCancel
UICancelOption. Especifica si se produce o no una excepción cuando el usuario cancela la operación. El valor predeterminado es UICancelOption.ThrowException. Obligatorio.

Excepciones

Las condiciones siguientes pueden producir una excepción:

La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; tiene una barra oblicua final a partir de la cual se debe especificar un archivo; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).
La ruta de acceso no es válida porque es Nothing (ArgumentNullException).
La ruta supera la longitud máxima definida por el sistema (PathTooLongException).
Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).
El archivo está en uso (IOException).
El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).
El archivo no existe (FileNotFoundException).
El usuario no tiene el permiso para eliminar el archivo o el archivo es de sólo lectura (UnauthorizedAccessException).
Una situación de confianza parcial en la que el usuario no tiene los permisos necesarios (SecurityException).
El usuario canceló la operación y el parámetro onUserCancel está establecido en UICancelOption.ThrowException (OperationCanceledException).

Comentarios

Los parámetros showUI, recycle y onUserCancel no se admiten en aplicaciones que no ofrecen interactividad para el usuario, como los Servicios de Windows.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.DeleteFile.

Para	Vea
Para eliminar un archivo	Cómo: Eliminar un archivo en Visual Basic
Para eliminar todos los archivos de un directorio	Cómo: Eliminar todos los archivos de un directorio en Visual Basic

Ejemplo

En este ejemplo se elimina el archivo Test.txt.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

Este ejemplo elimina el archivo Test.txt y permite al usuario confirmar la eliminación del archivo.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

Este ejemplo elimina el archivo Test.txt y lo envía a la Papelera de reciclaje.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.OnlyErrorDialogs, 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 interfaces de usuario y el Portapapeles. Enumeración asociada: SafeSubWindows.