FileSystem.DeleteFile FileSystem.DeleteFile FileSystem.DeleteFile FileSystem.DeleteFile Method

Definición

Elimina un archivo.Deletes a file.

Sobrecargas

DeleteFile(String) DeleteFile(String) DeleteFile(String) DeleteFile(String)

Elimina un archivo.Deletes a file.

DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption)

Elimina un archivo.Deletes a file.

DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Elimina un archivo.Deletes a file.

DeleteFile(String) DeleteFile(String) DeleteFile(String) DeleteFile(String)

Elimina un archivo.Deletes a file.

public:
 static void DeleteFile(System::String ^ file);
public static void DeleteFile (string file);
static member DeleteFile : string -> unit
Public Shared Sub DeleteFile (file As String)

Parámetros

file
String String String String

Nombre y ruta de acceso al archivo que se va a eliminar.Name and path of the file to be deleted.

Excepciones

La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; solo contiene un espacio en blanco; contiene caracteres no válidos; tiene una barra diagonal final a partir de la cual se debe especificar un archivo; o es una ruta de acceso de dispositivo (empieza por \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

file es Nothing o una cadena vacía.file is Nothing or an empty string.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.A file or directory name in the path contains a colon (:) or is in an invalid format.

El archivo está en uso.The file is in use.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.The user does not have permission to delete the file or the file is read-only.

Ejemplos

Este ejemplo elimina el archivo Test.txt.This example deletes the file Test.txt.

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

Este ejemplo elimina el archivo Test.txt y permite al usuario que confirme que el archivo debe eliminarse.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Comentarios

La tabla siguiente muestra un ejemplo de una tarea que implica la My.Computer.FileSystem.DeleteFile método.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

EnTo VeaSee
Para eliminar un archivoTo delete a file Cómo: Eliminar un archivo en Visual BasicHow to: Delete a File in Visual Basic

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption) DeleteFile(String, UIOption, RecycleOption)

Elimina un archivo.Deletes a file.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle);
public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle);
static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption -> unit
Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)

Parámetros

file
String String String String

Nombre y ruta de acceso al archivo que se va a eliminar.Name and path of the file to be deleted.

showUI
UIOption UIOption UIOption UIOption

Indica si se va a seguir visualmente el progreso de la operación.Whether to visually track the operation's progress. El valor predeterminado es UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption RecycleOption RecycleOption RecycleOption

Especifica si el archivo eliminado se va a enviar o no a la Papelera de reciclaje.Whether or not the deleted file should be sent to the Recycle Bin. El valor predeterminado es RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

Excepciones

La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; solo contiene un espacio en blanco; contiene caracteres no válidos; tiene una barra diagonal final a partir de la cual se debe especificar un archivo; o es una ruta de acceso de dispositivo (empieza por \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

file es Nothing o una cadena vacía.file is Nothing or an empty string.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.A file or directory name in the path contains a colon (:) or is in an invalid format.

El archivo está en uso.The file is in use.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.The user does not have permission to delete the file or the file is read-only.

Ejemplos

Este ejemplo elimina el archivo Test.txt.This example deletes the file Test.txt.

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

Este ejemplo elimina el archivo Test.txt y permite al usuario que confirme que el archivo debe eliminarse.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Comentarios

El showUI y recycle parámetros no se admiten en las aplicaciones que no son interactivo, como los servicios de Windows del usuario.The showUI and recycle parameters are not supported in applications that are not user interactive, such as Windows Services.

La tabla siguiente muestra un ejemplo de una tarea que implica la My.Computer.FileSystem.DeleteFile método.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

EnTo VeaSee
Para eliminar un archivoTo delete a file Cómo: Eliminar un archivo en Visual BasicHow to: Delete a File in Visual Basic

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Controla los permisos relacionados con las interfaces de usuario y al Portapapeles.Controls the permissions related to user interfaces and the clipboard. Enumeración asociada: SafeSubWindows.Associated enumeration: SafeSubWindows.

Consulte también:

DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption) DeleteFile(String, UIOption, RecycleOption, UICancelOption)

Elimina un archivo.Deletes a file.

public:
 static void DeleteFile(System::String ^ file, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::RecycleOption recycle, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void DeleteFile (string file, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.RecycleOption recycle, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member DeleteFile : string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.RecycleOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)

Parámetros

file
String String String String

Nombre y ruta de acceso al archivo que se va a eliminar.Name and path of the file to be deleted.

showUI
UIOption UIOption UIOption UIOption

Indica si se va a seguir visualmente el progreso de la operación.Whether to visually track the operation's progress. El valor predeterminado es UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

recycle
RecycleOption RecycleOption RecycleOption RecycleOption

Especifica si el archivo eliminado se va a enviar o no a la Papelera de reciclaje.Whether or not the deleted file should be sent to the Recycle Bin. El valor predeterminado es RecycleOption.DeletePermanently.Default is RecycleOption.DeletePermanently.

onUserCancel
UICancelOption UICancelOption UICancelOption UICancelOption

Especifica si se va a producir una excepción cuando el usuario cancele la operación.Specifies whether or not an exception is thrown when the user cancels the operation. El valor predeterminado es UICancelOption.ThrowException.Default is UICancelOption.ThrowException.

Excepciones

La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; solo contiene un espacio en blanco; contiene caracteres no válidos; tiene una barra diagonal final a partir de la cual se debe especificar un archivo; o es una ruta de acceso de dispositivo (empieza por \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; it has a trailing slash where a file must be specified; or it is a device path (starts with \\.\).

file es Nothing o una cadena vacía.file is Nothing or an empty string.

La ruta de acceso supera la longitud máxima definida por el sistema.The path exceeds the system-defined maximum length.

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.A file or directory name in the path contains a colon (:) or is in an invalid format.

El archivo está en uso.The file is in use.

El usuario no tiene los permisos necesarios para ver la ruta de acceso.The user lacks necessary permissions to view the path.

El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.The user does not have permission to delete the file or the file is read-only.

El usuario ha cancelado la operación y el parámetro onUserCancel está establecido en ThrowException.The user cancelled the operation and onUserCancel is set to ThrowException.

Ejemplos

Este ejemplo elimina el archivo Test.txt.This example deletes the file Test.txt.

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

Este ejemplo elimina el archivo Test.txt y permite al usuario que confirme que el archivo debe eliminarse.This example deletes the file Test.txt and allows the user to confirm that the file should be deleted.

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.This example deletes the file Test.txt and sends it to the Recycle Bin.

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

Comentarios

El showUI, recycle, y onUserCancel parámetros no se admiten en las aplicaciones que no son interactivo, como los servicios de Windows del usuario.The showUI, recycle, and onUserCancel parameters are not supported in applications that are not user interactive, such as Windows Services.

La tabla siguiente muestra un ejemplo de una tarea que implica la My.Computer.FileSystem.DeleteFile método.The following table lists an example of a task involving the My.Computer.FileSystem.DeleteFile method.

EnTo VeaSee
Para eliminar un archivoTo delete a file Cómo: Eliminar un archivo en Visual BasicHow to: Delete a File in Visual Basic

Seguridad

FileIOPermission
Controla la capacidad para tener acceso a archivos y carpetas.Controls the ability to access files and folders. Enumeración asociada: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Controla los permisos relacionados con las interfaces de usuario y al Portapapeles.Controls the permissions related to user interfaces and the clipboard. Enumeración asociada: SafeSubWindows.Associated enumeration: SafeSubWindows.

Consulte también:

Se aplica a