Compartir a través de


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

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

Biblioteca de clases

Aplicación de consola

Biblioteca de controles de Windows

Biblioteca de controles Web

Servicio de Windows

Sitio Web

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.

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Eliminar un directorio en Visual Basic

Referencia

My.Computer.FileSystem (Objeto)

UIOption (Enumeración)

RecycleOption (Enumeración)

UICancelOption (Enumeración)

FileSystem.DeleteFile

My.Computer.FileSystem (Objeto)