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

Definição

Abre um arquivo de texto, lê todas as linhas do arquivo em uma matriz de cadeia de caracteres e o fecha.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 um arquivo de texto, lê todas as linhas dele e o fecha.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 um arquivo, lê todas as linhas do arquivo com a codificação especificada e fecha o arquivo.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 um arquivo de texto, lê todas as linhas dele e o fecha.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

O arquivo a ser aberto para leitura.The file to open for reading.

Retornos

String[]

Uma matriz de cadeia de caracteres que contém todas as linhas do arquivo.A string array containing all lines of the file.

Exceções

path é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid (for example, it is on an unmapped drive).

Um erro de E/S ocorreu ao abrir o arquivo.An I/O error occurred while opening the file.

path especificou um arquivo somente leitura.path specified a file that is read-only.

- ou --or- Não há suporte para essa operação na plataforma atual.This operation is not supported on the current platform.

- ou --or- path especificou um diretório.path specified a directory.

- ou --or- O chamador não tem a permissão necessária.The caller does not have the required permission.

O arquivo especificado em path não foi encontrado.The file specified in path was not found.

path está em um formato inválido.path is in an invalid format.

O chamador não tem a permissão necessária.The caller does not have the required permission.

Exemplos

O exemplo de código a seguir demonstra o uso do ReadAllLines método para exibir o conteúdo de um arquivo.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. Neste exemplo um arquivo é criado, se ele ainda não existir, e o texto é adicionado a ele.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

Comentários

Este método abre um arquivo, lê cada linha do arquivo e, em seguida, adiciona cada linha como um elemento de uma matriz de cadeia de caracteres.This method opens a file, reads each line of the file, then adds each line as an element of a string array. Ele fecha o arquivo.It then closes the file. Uma é definida como uma sequência de caracteres seguidos por um retorno de carro ('\r'), uma alimentação de linha ('\n') ou um retorno de carro seguido imediatamente por uma linha de alimentação de linha.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. A cadeia de caracteres resultante não contém a terminação retorno de carro e/ou alimentação de linha.The resulting string does not contain the terminating carriage return and/or line feed.

Esse método tenta automaticamente detectar a codificação de um arquivo com base na presença de marcas de ordem de byte.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Formatos de codificação UTF-8 e UTF-32 (big-endian e little endian) pode ser detectados.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Segurança

FileIOPermission
para acesso de leitura de um arquivo ou diretório.for access to read from a file or directory. Enumeração associada: ReadAssociated enumeration: Read

Veja também

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

Abre um arquivo, lê todas as linhas do arquivo com a codificação especificada e fecha o arquivo.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

O arquivo a ser aberto para leitura.The file to open for reading.

encoding
Encoding Encoding Encoding Encoding

A codificação aplicada ao conteúdo do arquivo.The encoding applied to the contents of the file.

Retornos

String[]

Uma matriz de cadeia de caracteres que contém todas as linhas do arquivo.A string array containing all lines of the file.

Exceções

path é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid (for example, it is on an unmapped drive).

Um erro de E/S ocorreu ao abrir o arquivo.An I/O error occurred while opening the file.

path especificou um arquivo somente leitura.path specified a file that is read-only.

- ou --or- Não há suporte para essa operação na plataforma atual.This operation is not supported on the current platform.

- ou --or- path especificou um diretório.path specified a directory.

- ou --or- O chamador não tem a permissão necessária.The caller does not have the required permission.

O arquivo especificado em path não foi encontrado.The file specified in path was not found.

path está em um formato inválido.path is in an invalid format.

O chamador não tem a permissão necessária.The caller does not have the required permission.

Exemplos

O exemplo de código a seguir demonstra o uso do ReadAllLines método para exibir o conteúdo de um arquivo.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. Neste exemplo um arquivo é criado, se ele ainda não existir, e o texto é adicionado a ele.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

Comentários

Este método abre um arquivo, lê cada linha do arquivo e, em seguida, adiciona cada linha como um elemento de uma matriz de cadeia de caracteres.This method opens a file, reads each line of the file, and then adds each line as an element of a string array. Ele fecha o arquivo.It then closes the file. Uma é definida como uma sequência de caracteres seguidos por um retorno de carro ('\r'), uma alimentação de linha ('\n') ou um retorno de carro seguido imediatamente por uma linha de alimentação de linha.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. A cadeia de caracteres resultante não contém a terminação retorno de carro e/ou alimentação de linha.The resulting string does not contain the terminating carriage return and/or line feed.

Esse método tenta automaticamente detectar a codificação de um arquivo com base na presença de marcas de ordem de byte.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Formatos de codificação UTF-8 e UTF-32 (big-endian e little endian) pode ser detectados.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Segurança

FileIOPermission
para acesso de leitura de um arquivo ou diretório.for access to read from a file or directory. Enumeração associada: ReadAssociated enumeration: Read

Veja também

Aplica-se a