File.ReadAllLines Método

  • Referencia

Definición

Espacio de nombres:
System.IO
Ensamblados:
mscorlib.dll, System.IO.FileSystem.dll
Ensamblado:
System.IO.FileSystem.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.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)

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

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path);
public static string[] ReadAllLines (string path);
static member ReadAllLines : string -> string[]
Public Shared Function ReadAllLines (path As String) As String()

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.

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

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText)
        End If

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

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

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

Se aplica a

ReadAllLines(String, Encoding)

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

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path, System::Text::Encoding ^ encoding);
public static string[] ReadAllLines (string path, System.Text.Encoding encoding);
static member ReadAllLines : string * System.Text.Encoding -> string[]
Public Shared Function ReadAllLines (path As String, encoding As Encoding) As String()

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.

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

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText, Encoding.UTF8)
        End If

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

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path, Encoding.UTF8)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

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

Se aplica a