FileSystemProxy.DeleteFile Método

Definición

Espacio de nombres:

Microsoft.VisualBasic.MyServices

Ensamblado:

Microsoft.VisualBasic.Forms.dll

Elimina un archivo.

Sobrecargas

DeleteFile(String)	Elimina un archivo.
DeleteFile(String, UIOption, RecycleOption)	Elimina un archivo.
DeleteFile(String, UIOption, RecycleOption, UICancelOption)	Elimina un archivo.

DeleteFile(String)

Elimina un archivo.

public:
 void DeleteFile(System::String ^ file);

public void DeleteFile (string file);

member this.DeleteFile : string -> unit

Public Sub DeleteFile (file As String)

Parámetros

file

String

Nombre y ruta de acceso al archivo que se va a eliminar.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; tiene una barra diagonal final donde se debe especificar un archivo; o es una ruta de acceso del dispositivo (comienza por \\.\).

ArgumentNullException

file es Nothing o una cadena vacía.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

IOException

El archivo está en uso.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

FileNotFoundException

El archivo no existe.

UnauthorizedAccessException

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.

Ejemplos

En este ejemplo se elimina el archivo Test.txt.

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

En este ejemplo se elimina el archivo Test.txt y se permite al usuario confirmar que se debe eliminar el archivo.

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

En este ejemplo se elimina el archivo Test.txt y se envía a la Papelera de reciclaje.

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

Comentarios

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.DeleteFile método .

En	Vea
Para eliminar un archivo	Procedimiento para eliminar un archivo

Consulte también

• Objetos (Visual Basic)
• Cómo: Eliminar un archivo en Visual Basic

DeleteFile(String, UIOption, RecycleOption)

Elimina un archivo.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

Parámetros

file

String

Nombre y ruta de acceso al archivo que se va a eliminar.

showUI

UIOption

Indica si se va a seguir visualmente el progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Especifica si el archivo eliminado se va a enviar o no a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; tiene una barra diagonal final donde se debe especificar un archivo; o es una ruta de acceso del dispositivo (comienza por \\.\).

ArgumentNullException

file es Nothing o una cadena vacía.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

IOException

El archivo está en uso.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

FileNotFoundException

El archivo no existe.

UnauthorizedAccessException

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.

Ejemplos

En este ejemplo se elimina el archivo Test.txt.

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

En este ejemplo se elimina el archivo Test.txt y se permite al usuario confirmar que se debe eliminar el archivo.

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

En este ejemplo se elimina el archivo Test.txt y se envía a la Papelera de reciclaje.

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

Comentarios

Los showUI parámetros y recycle no se admiten en aplicaciones que no son interactivas por el usuario, como los servicios de Windows.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.DeleteFile método .

En	Vea
Para eliminar un archivo	Procedimiento para eliminar un archivo

Consulte también

• RecycleOption
• UIOption
• Objetos (Visual Basic)
• Cómo: Eliminar un archivo en Visual Basic

DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Elimina un archivo.

public:
 void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parámetros

file

String

Nombre y ruta de acceso al archivo que se va a eliminar.

showUI

UIOption

Indica si se va a seguir visualmente el progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

recycle

RecycleOption

Especifica si el archivo eliminado se va a enviar o no a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently.

onUserCancel

UICancelOption

Especifica si se va a producir una excepción cuando el usuario cancele la operación. El valor predeterminado es UICancelOption.ThrowException.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; tiene una barra diagonal final donde se debe especificar un archivo; o es una ruta de acceso del dispositivo (comienza por \\.\).

ArgumentNullException

file es Nothing o una cadena vacía.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

IOException

El archivo está en uso.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

FileNotFoundException

El archivo no existe.

UnauthorizedAccessException

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.

OperationCanceledException

El usuario ha cancelado la operación y el parámetro onUserCancel está establecido en ThrowException.

Ejemplos

En este ejemplo se elimina el archivo Test.txt.

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

En este ejemplo se elimina el archivo Test.txt y se permite al usuario confirmar que se debe eliminar el archivo.

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

En este ejemplo se elimina el archivo Test.txt y se envía a la Papelera de reciclaje.

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

Comentarios

Los showUIparámetros , recycley onUserCancel no se admiten en aplicaciones que no son interactivas por el usuario, como servicios de Windows.

En la tabla siguiente se enumeran ejemplos de tareas que implican el My.Computer.FileSystem.DeleteFile método .

En	Vea
Para eliminar un archivo	Procedimiento para eliminar un archivo

Consulte también

• UICancelOption
• RecycleOption
• UIOption
• Objetos (Visual Basic)
• Cómo: Eliminar un archivo en Visual Basic