File.ReadAllLines File.ReadAllLines File.ReadAllLines File.ReadAllLines Method

Definición

Abre un archivo de texto, lee todas sus líneas, las introduce en una matriz de cadenas y, a continuación, cierra el archivo.Opens a text file, reads all lines of the file into a string array, and then closes the file.

Sobrecargas

ReadAllLines(String) ReadAllLines(String) ReadAllLines(String) ReadAllLines(String)

Abre un archivo de texto, lee todas sus líneas y, a continuación, cierra el archivo.Opens a text file, reads all lines of the file, and then closes the file.

ReadAllLines(String, Encoding) ReadAllLines(String, Encoding) ReadAllLines(String, Encoding)

Abre un archivo, lee todas sus líneas con la codificación especificada y, a continuación, cierra el archivo.Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

ReadAllLines(String) ReadAllLines(String) ReadAllLines(String) ReadAllLines(String)

Abre un archivo de texto, lee todas sus líneas y, a continuación, cierra el archivo.Opens a text file, reads all lines of the file, and then closes the file.

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 String String String

Archivo que se abre para la lectura.The file to open for reading.

Devoluciones

String[]

Una matriz de cadenas que contiene todas las líneas del archivo.A string array containing all lines of the file.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- path especificó un directorio.path specified a directory.

o bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

No se encontró el archivo especificado en path.The file specified in path was not found.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el ReadAllLines uso del método para mostrar el contenido de un archivo.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. En este ejemplo, se crea un archivo, si aún no existe, y se le agrega texto.In this example a file is created, if it doesn't already exist, and text is added to it.

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
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.This method opens a file, reads each line of the file, then adds each line as an element of a string array. A continuación, cierra el archivo.It then closes the file. Una línea se define como una secuencia de caracteres seguida de un retorno de carro (' \r '), un salto de línea (' \n ') o un retorno de carro seguido inmediatamente de un salto de línea.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. La cadena resultante no contiene el retorno de carro o el avance de línea de terminación.The resulting string does not contain the terminating carriage return and/or line feed.

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.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Se pueden detectar los formatos de codificación UTF-8 y UTF-32 (Big-endian y Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Seguridad

FileIOPermission
para obtener acceso para leer desde un archivo o un directorio.for access to read from a file or directory. Enumeración asociada:ReadAssociated enumeration: Read

Consulte también:

ReadAllLines(String, Encoding) ReadAllLines(String, Encoding) ReadAllLines(String, Encoding)

Abre un archivo, lee todas sus líneas con la codificación especificada y, a continuación, cierra el archivo.Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

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[]

Parámetros

path
String String String String

Archivo que se abre para la lectura.The file to open for reading.

encoding
Encoding Encoding Encoding Encoding

Codificación aplicada al contenido del archivo.The encoding applied to the contents of the file.

Devoluciones

String[]

Una matriz de cadenas que contiene todas las líneas del archivo.A string array containing all lines of the file.

Excepciones

path es una cadena de longitud cero que solo contiene espacios en blanco o uno o varios caracteres no válidos definidos por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada no es válida (por ejemplo, está en una unidad no asignada).The specified path is invalid (for example, it is on an unmapped drive).

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

path especificó un archivo que es de solo lectura.path specified a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- path especificó un directorio.path specified a directory.

O bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

No se encontró el archivo especificado en path.The file specified in path was not found.

path está en un formato no válido.path is in an invalid format.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se muestra el ReadAllLines uso del método para mostrar el contenido de un archivo.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. En este ejemplo, se crea un archivo, si aún no existe, y se le agrega texto.In this example a file is created, if it doesn't already exist, and text is added to it.

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
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.This method opens a file, reads each line of the file, and then adds each line as an element of a string array. A continuación, cierra el archivo.It then closes the file. Una línea se define como una secuencia de caracteres seguida de un retorno de carro (' \r '), un salto de línea (' \n ') o un retorno de carro seguido inmediatamente de un salto de línea.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. La cadena resultante no contiene el retorno de carro o el avance de línea de terminación.The resulting string does not contain the terminating carriage return and/or line feed.

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.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Se pueden detectar los formatos de codificación UTF-8 y UTF-32 (Big-endian y Little-endian).Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Seguridad

FileIOPermission
para obtener acceso para leer desde un archivo o un directorio.for access to read from a file or directory. Enumeración asociada:ReadAssociated enumeration: Read

Consulte también:

Se aplica a