File.ReadAllLines Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Abre un archivo de texto, lee todas sus líneas, las introduce en una matriz de cadenas y, a continuación, cierra el archivo.

Sobrecargas

ReadAllLines(String)	Abre un archivo de texto, lee todas sus líneas y, a continuación, cierra el archivo.
ReadAllLines(String, Encoding)	Abre un archivo, lee todas sus líneas con la codificación especificada y, a continuación, cierra el archivo.

ReadAllLines(String)

Source:

File.cs

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

C#

public static string[] ReadAllLines (string path);

Parámetros

path

String

Archivo que se abre para la lectura.

Devoluciones

String[]

Una matriz de cadenas que contiene todas las líneas del archivo.

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Se produjo un error de E/S al abrir el archivo.

UnauthorizedAccessException

path especificó un archivo que es de solo lectura.

o bien

Esta operación no es compatible con la plataforma actual.

o bien

path especificó un directorio.

o bien

El llamador no dispone del permiso requerido.

FileNotFoundException

No se encontró el archivo especificado en path.

NotSupportedException

path está en un formato no válido.

SecurityException

El llamador no dispone del permiso requerido.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del ReadAllLines método para mostrar el contenido de un archivo. En este ejemplo se crea un archivo, si aún no existe y se agrega texto a él.

C#

using System;
using System.IO;
class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}

Comentarios

Este método abre un archivo, lee cada línea del archivo y, a continuación, agrega cada línea como un elemento de una matriz de cadenas. A continuación, cierra el archivo. Una línea se define como una secuencia de caracteres seguida de un retorno de carro ('\r'), una fuente de línea ('\n') o un retorno de carro inmediatamente seguido de una fuente de línea. La cadena resultante no contiene el retorno de carro de terminación ni la alimentación de línea.

Este método intenta detectar automáticamente la codificación de un archivo en función de la presencia de marcas de orden de bytes. Se pueden detectar formatos de codificación UTF-8 y UTF-32 (big-endian y little-endian).

Consulte también

• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado

ReadAllLines(String, Encoding)

Source:

File.cs

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

C#

public static string[] ReadAllLines (string path, System.Text.Encoding encoding);

Parámetros

path

String

Archivo que se abre para la lectura.

encoding

Encoding

Codificación aplicada al contenido del archivo.

Devoluciones

String[]

Una matriz de cadenas que contiene todas las líneas del archivo.

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene uno o varios caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

ArgumentNullException

path es null.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

DirectoryNotFoundException

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).

IOException

Se produjo un error de E/S al abrir el archivo.

UnauthorizedAccessException

path especificó un archivo que es de solo lectura.

o bien

Esta operación no es compatible con la plataforma actual.

o bien

path especificó un directorio.

o bien

El llamador no dispone del permiso requerido.

FileNotFoundException

No se encontró el archivo especificado en path.

NotSupportedException

path está en un formato no válido.

SecurityException

El llamador no dispone del permiso requerido.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del ReadAllLines método para mostrar el contenido de un archivo. En este ejemplo se crea un archivo, si aún no existe y se agrega texto a él.

C#

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}

Comentarios

Este método abre un archivo, lee cada línea del archivo y, a continuación, agrega cada línea como un elemento de una matriz de cadenas. A continuación, cierra el archivo. Una línea se define como una secuencia de caracteres seguida de un retorno de carro ('\r'), una fuente de línea ('\n') o un retorno de carro inmediatamente seguido de una fuente de línea. La cadena resultante no contiene el retorno de carro de terminación ni la alimentación de línea.

Este método intenta detectar automáticamente la codificación de un archivo en función de la presencia de marcas de orden de bytes. Se pueden detectar formatos de codificación UTF-8 y UTF-32 (big-endian y little-endian).

Consulte también

• E/S de archivos y secuencias
• Leer texto de un archivo
• Cómo: Escribir texto en un archivo
• Cómo: Leer y escribir en un archivo de datos recién creado