File (Clase)

Utilice la clase File para operaciones como copiar, mover, cambiar el nombre, crear, abrir, eliminar y anexar texto a archivos. También puede utilizar la clase File para obtener y definir atributos de archivo o información de DateTime relacionada con la creación, el acceso y la escritura de un archivo.

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

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

Los métodos estáticos de la clase File realizan comprobaciones de seguridad en todos los métodos. Si va a utilizar un objeto varias veces, considere la posibilidad de usar el correspondiente método de instancia de FileInfo, ya que no siempre es necesario realizar una comprobación de seguridad.

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

En la tabla siguiente se describen las enumeraciones que se utilizan para personalizar el comportamiento de varios métodos de File.

Nota

En los miembros que aceptan una ruta como cadena de entrada, la ruta debe ser correcta o, de lo contrario, se produce una excepción. Por ejemplo, si se trata de una ruta de acceso completa pero que empieza por un espacio, la ruta no se recorta en los métodos de la clase. En consecuencia, la ruta está mal construida y se produce una excepción. De forma similar, no se puede especificar dos veces el nombre completo de una ruta de acceso o una combinación de rutas de acceso. Por ejemplo, "c:\temp c:\windows" produce también una excepción en la mayoría de los casos. Asegúrese de que las rutas de acceso estén bien construidas cuando utilice métodos que acepten una cadena de ruta de acceso.

En los miembros que aceptan una ruta de acceso, esta ruta puede hacer referencia a un archivo o sólo a un directorio. La ruta especificada puede hacer referencia también a una ruta relativa o a una ruta de convención de nomenclatura universal (Universal Naming Convention, UNC) de un servidor y un nombre de recurso compartido. Por ejemplo, las siguientes rutas de acceso son todas válidas:

• "c:\\MiDir\\MiArchivo.txt" en C# o "c:\MiDir\MiArchivo.txt" en Visual Basic.

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

• "MiDir\\MiSubdir" en C# o "MiDir\MiSubDir" en Visual Basic.

• "\\\\MiServidor\\MiRecursoComp" en C# o "\\MiServidor\MiRecursoComp" en Visual Basic.

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

En el siguiente ejemplo se muestran algunos de los miembros principales de la clase File.

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);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos