FileSystem.DeleteFile Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Elimina un archivo.
Sobrecargas
| Nombre | Description |
|---|---|
| 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:
static void DeleteFile(System::String ^ file);public static void DeleteFile(string file);static member DeleteFile : string -> unitPublic Shared Sub DeleteFile (file As String)Parámetros
- file
- String
Nombre y ruta de acceso del archivo que se va a eliminar.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene 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 \\.\).
file es Nothing o una cadena vacía.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El archivo está en uso.
El usuario carece de permisos necesarios para ver la ruta de acceso.
El archivo no existe.
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 muestra un ejemplo de una tarea que implica el My.Computer.FileSystem.DeleteFile método .
| En | Vea |
|---|---|
| Para eliminar un archivo | Cómo eliminar un archivo en Visual Basic |
Se aplica a
DeleteFile(String, UIOption, RecycleOption)
Elimina un archivo.
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 -> unitPublic Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption)Parámetros
- file
- String
Nombre y ruta de acceso del archivo que se va a eliminar.
- showUI
- UIOption
Indica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.
- recycle
- RecycleOption
Indica si el archivo eliminado se debe enviar a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene 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 \\.\).
file es Nothing o una cadena vacía.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El archivo está en uso.
El usuario carece de permisos necesarios para ver la ruta de acceso.
El archivo no existe.
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 parámetros showUI y recycle no se admiten en aplicaciones que no son interactivas por el usuario, como Windows Services.
En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.FileSystem.DeleteFile método .
| En | Vea |
|---|---|
| Para eliminar un archivo | Cómo eliminar un archivo en Visual Basic |
Consulte también
Se aplica a
DeleteFile(String, UIOption, RecycleOption, UICancelOption)
Elimina un archivo.
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 -> unitPublic Shared Sub DeleteFile (file As String, showUI As UIOption, recycle As RecycleOption, onUserCancel As UICancelOption)Parámetros
- file
- String
Nombre y ruta de acceso del archivo que se va a eliminar.
- showUI
- UIOption
Indica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.
- recycle
- RecycleOption
Indica si el archivo eliminado se debe enviar a la Papelera de reciclaje. El valor predeterminado es RecycleOption.DeletePermanently.
- onUserCancel
- UICancelOption
Especifica si se produce o no una excepción cuando el usuario cancela la operación. El valor predeterminado es UICancelOption.ThrowException.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene 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 \\.\).
file es Nothing o una cadena vacía.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El archivo está en uso.
El usuario carece de permisos necesarios para ver la ruta de acceso.
El archivo no existe.
El usuario no tiene permiso para eliminar el archivo o el archivo es de solo lectura.
El usuario canceló la operación y onUserCancel se establece 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 parámetros showUI, recycle y onUserCancel no se admiten en aplicaciones que no son interactivas por el usuario, como Windows Services.
En la tabla siguiente se muestra un ejemplo de una tarea que implica el My.Computer.FileSystem.DeleteFile método .
| En | Vea |
|---|---|
| Para eliminar un archivo | Cómo eliminar un archivo en Visual Basic |