File.ReadAllLines Método

Definición

Espacio de nombres:: System.IO

Ensamblados:: mscorlib.dll, System.IO.FileSystem.dll

Ensamblados:: netstandard.dll, System.Runtime.dll

Ensamblados:: netstandard.dll, System.IO.FileSystem.dll

Ensamblados:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Ensamblado:: System.IO.FileSystem.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

Sobrecargas

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

ReadAllLines(String)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Source:: File.cs

Source:: File.cs

Abre un archivo de texto, lee todas las líneas del archivo 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 va a abrir para su lectura.

Devoluciones

String[]

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

Excepciones

ArgumentException

Versiones de .NET Framework y .NET Core anteriores a la 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 caracteres no válidos mediante 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

Error de E/S al abrir el archivo.

UnauthorizedAccessException

Esta operación no se admite en la plataforma actual.

O bien

path especificó un directorio.

O bien

El autor de la llamada no tiene el permiso necesario.

FileNotFoundException

No se encontró el archivo especificado en path .

NotSupportedException

path tiene un formato no válido.

SecurityException

El autor de la llamada no tiene el permiso necesario.

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

open System
open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let createText = [ "Hello"; "And"; "Welcome" ]
    File.WriteAllLines(path, createText)

// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllLines path

for s in readText do
    printfn $"{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'), un avance de línea ('\n') o un retorno de carro inmediatamente seguido de un avance de línea. La cadena resultante no contiene el retorno de carro de terminación ni la alimentación de línea.

Si el archivo finaliza con una secuencia de nueva línea, no se anexa ninguna línea vacía adicional a la matriz. Por ejemplo, un archivo que contiene "line1\nline2\n" genera la misma matriz de dos elementos (["line1", "line2"]) que un archivo que contiene "line1\nline2".

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)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Source:: File.cs

Source:: File.cs

Abre un archivo, lee todas las líneas del archivo 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 va a abrir para su lectura.

encoding: Encoding

Codificación aplicada al contenido del archivo.

Devoluciones

String[]

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

Excepciones

ArgumentException

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

Error de E/S al abrir el archivo.

UnauthorizedAccessException

Esta operación no se admite en la plataforma actual.

O bien

path especificó un directorio.

O bien

El autor de la llamada no tiene el permiso necesario.

FileNotFoundException

No se encontró el archivo especificado en path .

NotSupportedException

path tiene un formato no válido.

SecurityException

El autor de la llamada no tiene el permiso necesario.

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

open System
open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllLines(path, Encoding.UTF8)

for s in readText do
    printfn $"{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

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?