Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase File

 

Publicado: octubre de 2016

Proporciona métodos estáticos para crear, copiar, eliminar, mover y abrir un solo archivo, y contribuye a la creación de objetos FileStream.

Para examinar el código fuente de .NET Framework para este tipo, vea la Reference Source.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)


[ComVisibleAttribute(true)]
public static class File

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>)

Anexa líneas a un archivo y, a continuación, cierra el archivo. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en él y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>, Encoding)

Anexa líneas a un archivo usando la codificación especificada y, a continuación, lo cierra. Si el archivo especificado no existe, este método crea un archivo, escribe las líneas especificadas en él y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String)

Abre un archivo, le anexa la cadena especificada y, a continuación, cierra el archivo. Si el archivo no existe, este método crea un archivo, escribe la cadena especificada en él y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String, Encoding)

Anexa la cadena especificada al archivo y crea el archivo si aún no existe.

System_CAPS_pubmethodSystem_CAPS_staticAppendText(String)

Crea un StreamWriter que anexa texto codificado UTF-8 a un archivo existente o a un nuevo archivo si el archivo especificado no existe.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String)

Copia un archivo existente en un archivo nuevo. No se permite sobrescribir un archivo del mismo nombre.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String, Boolean)

Copia un archivo existente en un archivo nuevo. Se permite sobrescribir un archivo del mismo nombre.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

Crea o sobrescribe un archivo en la ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32)

Crea o sobrescribe el archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions)

Crea o sobrescribe el archivo especificado, especificando un tamaño de búfer y un valor de FileOptions que describe cómo crear o sobrescribir el archivo.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions, FileSecurity)

Crea o sobrescribe el archivo especificado con el tamaño de búfer, las opciones de archivo y la seguridad de archivo especificados.

System_CAPS_pubmethodSystem_CAPS_staticCreateText(String)

Crea o abre un archivo para escribir texto con codificación UTF-8.

System_CAPS_pubmethodSystem_CAPS_staticDecrypt(String)

Descifra un archivo cifrado por la cuenta actual mediante el método Encrypt.

System_CAPS_pubmethodSystem_CAPS_staticDelete(String)

Elimina el archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticEncrypt(String)

Cifra un archivo de forma que solo la cuenta utilizada para cifrarlo pueda descifrarlo.

System_CAPS_pubmethodSystem_CAPS_staticExists(String)

Determina si existe el archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String)

Obtiene un objeto FileSecurity que encapsula las entradas de la lista de control de acceso (ACL) para un archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String, AccessControlSections)

Obtiene un objeto FileSecurity que encapsula el tipo especificado de las entradas de la lista de control de acceso (ACL) para un archivo determinado.

System_CAPS_pubmethodSystem_CAPS_staticGetAttributes(String)

Obtiene el FileAttributes del archivo en la ruta de acceso.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTime(String)

Devuelve la fecha y hora de creación del archivo o el directorio especificados.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTimeUtc(String)

Devuelve la fecha y la hora de creación, en formato de hora universal coordinada (UTC), del archivo o directorio especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTime(String)

Devuelve la fecha y hora a la que se produjo el último acceso al archivo o directorio especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTimeUtc(String)

Devuelve la fecha y la hora, en formato de hora universal coordinada (UTC), a la que se produjo el último acceso al archivo o directorio especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTime(String)

Devuelve la fecha y hora a la que se escribió por última vez en el archivo o directorio especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTimeUtc(String)

Devuelve la fecha y la hora, en formato de hora universal coordinada (UTC), a la que se escribió por última vez en el archivo o directorio especificado.

System_CAPS_pubmethodSystem_CAPS_staticMove(String, String)

Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para indicar un nuevo nombre de archivo.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode)

Abre un FileStream en la ruta de acceso especificada con acceso de lectura y escritura.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess)

Abre un FileStream en la ruta de acceso especificada, con el modo y acceso especificados.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess, FileShare)

Abre un FileStream en la ruta de acceso especificada con el modo especificado, con acceso de lectura, escritura o ambos, y la opción de uso compartido especificada.

System_CAPS_pubmethodSystem_CAPS_staticOpenRead(String)

Abre un archivo existente para lectura.

System_CAPS_pubmethodSystem_CAPS_staticOpenText(String)

Abre un archivo de texto existente con codificación UTF-8 para lectura.

System_CAPS_pubmethodSystem_CAPS_staticOpenWrite(String)

Abre un archivo existente o crea un nuevo archivo para escribir en él.

System_CAPS_pubmethodSystem_CAPS_staticReadAllBytes(String)

Abre un archivo binario, lee su contenido, lo introduce en una matriz de bytes y, a continuación, cierra el archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String)

Abre un archivo de texto, lee todas sus líneas y, a continuación, cierra el archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String, Encoding)

Abre un archivo, lee todas sus líneas con la codificación especificada y, a continuación, cierra el archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String)

Abre un archivo de texto, lee todas sus líneas y, a continuación, cierra el archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String, Encoding)

Abre un archivo, lee todas sus líneas con la codificación especificada y, a continuación, cierra el archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String)

Lee las líneas de un archivo.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String, Encoding)

Lee las líneas de un archivo que tiene una codificación especificada.

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original y crea una copia de seguridad del archivo reemplazado.

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String, Boolean)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original, crea una copia de seguridad del archivo reemplazado y, de forma opcional, omite los errores de combinación.

System_CAPS_pubmethodSystem_CAPS_staticSetAccessControl(String, FileSecurity)

Aplica al archivo especificado las entradas de la lista de control de acceso (ACL) descritas por un objeto FileSecurity.

System_CAPS_pubmethodSystem_CAPS_staticSetAttributes(String, FileAttributes)

Establece el FileAttributes especificado del archivo en la ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTime(String, DateTime)

Establece la fecha y la hora a la que se creó el archivo.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTimeUtc(String, DateTime)

Establece la fecha y la hora, en formato de hora universal coordinada (UTC), a la que se creó el archivo.

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTime(String, DateTime)

Establece la fecha y la hora en que se obtuvo acceso por última vez al archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTimeUtc(String, DateTime)

Establece la fecha y la hora, en formato de hora universal coordinada (UTC), a la que se produjo el último acceso al archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTime(String, DateTime)

Establece la fecha y la hora en que escribió por última vez en el archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTimeUtc(String, DateTime)

Establece la fecha y la hora, en formato de hora universal coordinada (UTC), a la que se escribió por última vez en el archivo especificado.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllBytes(String, Byte[])

Crea un archivo nuevo, escribe en él la matriz de bytes especificada y, a continuación, lo cierra. Si el archivo de destino ya existe, se sobrescribe.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>)

Crea un archivo nuevo, escribe una colección de cadenas en él y lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>, Encoding)

Crea un archivo nuevo usando la codificación especificada, escribe en él la colección de cadenas especificada y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[])

Crea un archivo nuevo, escribe en él la matriz de cadenas especificada y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[], Encoding)

Crea un archivo nuevo, escribe en él la matriz de cadenas especificada usando la codificación especificada y, a continuación, lo cierra.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String)

Crea un archivo nuevo, escribe la cadena especificada en él y, a continuación, lo cierra. Si el archivo de destino ya existe, se sobrescribe.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String, Encoding)

Crea un archivo nuevo, escribe en él la cadena especificada con la codificación especificada y, a continuación, lo cierra. Si el archivo de destino ya existe, se sobrescribe.

System_CAPS_noteNota

Para ver el código fuente de .NET Framework para este tipo, consulte el Reference Source. Puede examinar el código fuente en línea, descargue la referencia para verla sin conexión y recorrer (incluidas las revisiones y actualizaciones) durante la depuración; see instructions.

Utilice la File clase para operaciones típicas como copiar, mover, cambiar el nombre, crear, abrir, eliminar y anexar a un único archivo a la vez. También puede utilizar el File clase para obtener y establecer atributos de archivo o DateTime información relacionada con la creación, acceso y la escritura de un archivo. Si desea realizar operaciones en varios archivos, consulte Directory.GetFiles o DirectoryInfo.GetFiles.

Muchos de los File métodos devuelven otros tipos de E/S al crear o abrir archivos. Puede utilizar estos otros tipos para seguir manipulando un archivo. Para obtener más información, consulte específico File miembros como OpenText, CreateText, o Create.

Dado que todos los File métodos son estáticos, puede resultar más eficaz usar un File método en lugar del correspondiente FileInfo método de instancia, si desea realizar sólo una operación. Todos los File métodos requieren la ruta de acceso al archivo que se está manipulando.

Los métodos estáticos de la File clase realizar comprobaciones de seguridad en todos los métodos. Si va a utilizar un objeto varias veces, considere el uso del método de instancia correspondiente de FileInfo en su lugar, porque la comprobación de seguridad no siempre que sea necesario.

De forma predeterminada, se concede acceso de lectura y escritura a los nuevos archivos a todos los usuarios.

La tabla siguiente describen las enumeraciones que se utilizan para personalizar el comportamiento de diversos File métodos.

Enumeración

Descripción

FileAccess

Especifica el acceso de lectura y escritura en un archivo.

FileShare

Especifica el nivel de acceso permitido para un archivo que ya está en uso.

FileMode

Especifica si se conserva o se sobrescribe el contenido de un archivo existente, y si las solicitudes para crear un archivo existente producirá una excepción.

System_CAPS_noteNota

En los miembros que aceptan una ruta de acceso como una cadena de entrada, esa ruta de acceso debe ser correcto o se produce una excepción. Por ejemplo, si una ruta de acceso está completa pero comienza con un espacio, la ruta no se recorta en los métodos de la clase. Por lo tanto, la ruta de acceso es incorrecto y se produce una excepción. De forma similar, una ruta de acceso o una combinación de rutas de acceso no puede completarse dos veces. Por ejemplo, "c:\temp c:\windows" también genera una excepción en la mayoría de los casos. Asegúrese de que las rutas de acceso sean correctos cuando se utilizan los métodos que aceptan una cadena de ruta de acceso.

En los miembros que aceptan una ruta de acceso, la ruta de acceso puede hacer referencia a un archivo o solo a un directorio. La ruta de acceso especificada puede hacer referencia a una ruta de acceso relativa o una ruta de acceso de convención de nomenclatura Universal (UNC) para un nombre de servidor y recurso compartido. Por ejemplo, todos los requisitos siguientes son las rutas de acceso aceptables:

  • "c:\\MyDir\\MyFile.txt" en C# o "c:\MyDir\MyFile.txt" en Visual Basic.

  • "c:\\MyDir" en C# o "c:\MyDir" en Visual Basic.

  • "Midir\\misubdir" en C# o "Midir\misubdir" en Visual Basic.

  • "\\\MyServer\\MyShare" en C#, o "\\MyServer\MyShare" en Visual Basic.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

En el ejemplo siguiente se muestra cómo utilizar el File (clase) para comprobar si existe un archivo, y según el resultado, cree un nuevo archivo y escribir en él, o abrir el archivo existente y leer de él. Antes de ejecutar el código, cree un c:\temp carpeta.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: