File.ReadAllText Método

Definição

Abre um arquivo de texto, lê todo o texto no arquivo em uma cadeia de caracteres e o fecha.Opens a text file, reads all the text in the file into a string, and then closes the file.

Sobrecargas

ReadAllText(String, Encoding)

Abre um arquivo, lê todo o texto no arquivo com a codificação especificada e fecha o arquivo.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

ReadAllText(String)

Abre um arquivo de texto, lê todo o texto no arquivo e o fecha.Opens a text file, reads all the text in the file, and then closes the file.

ReadAllText(String, Encoding)

Abre um arquivo, lê todo o texto no arquivo com a codificação especificada e fecha o arquivo.Opens a file, reads all text in the file with the specified encoding, and then closes the file.

public:
 static System::String ^ ReadAllText(System::String ^ path, System::Text::Encoding ^ encoding);
public static string ReadAllText (string path, System.Text.Encoding encoding);
static member ReadAllText : string * System.Text.Encoding -> string

Parâmetros

path
String

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

encoding
Encoding

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

Retornos

Uma cadeia de caracteres que contém todo o texto no arquivo.A string containing all text in 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.

path é null.path is null.

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 método ReadAllText para exibir o conteúdo de um arquivo.The following code example demonstrates the use of the ReadAllText 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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Comentários

Esse método abre um arquivo, lê todo o texto no arquivo e o retorna como uma cadeia de caracteres.This method opens a file, reads all the text in the file, and returns it as a string. Em seguida, ele fecha o arquivo.It then closes the file.

Esse método tenta detectar automaticamente 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) podem ser detectados.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

É garantido que o identificador do arquivo seja fechado por esse método, mesmo que as exceções sejam geradas.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Para usar as configurações de codificação conforme configurado para seu sistema operacional, especifique a propriedade Encoding.Default para o parâmetro encoding.To use the encoding settings as configured for your operating system, specify the Encoding.Default property for the encoding parameter.

Segurança

FileIOPermission
para acesso a 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

ReadAllText(String)

Abre um arquivo de texto, lê todo o texto no arquivo e o fecha.Opens a text file, reads all the text in the file, and then closes the file.

public:
 static System::String ^ ReadAllText(System::String ^ path);
public static string ReadAllText (string path);
static member ReadAllText : string -> string
Public Shared Function ReadAllText (path As String) As String

Parâmetros

path
String

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

Retornos

Uma cadeia de caracteres que contém todo o texto no arquivo.A string containing all the text in 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.

path é null.path is null.

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 método ReadAllText para exibir o conteúdo de um arquivo.The following code example demonstrates the use of the ReadAllText 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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

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

        ' 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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Comentários

Esse método abre um arquivo, lê todo o texto no arquivo e o retorna como uma cadeia de caracteres.This method opens a file, reads all the text in the file, and returns it as a string. Em seguida, ele fecha o arquivo.It then closes the file.

Esse método tenta detectar automaticamente 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) podem ser detectados.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Use a sobrecarga do método de ReadAllText(String, Encoding) ao ler arquivos que podem conter texto importado, porque caracteres não reconhecidos podem não ser lidos corretamente.Use the ReadAllText(String, Encoding) method overload when reading files that might contain imported text, because unrecognized characters may not be read correctly.

É garantido que o identificador do arquivo seja fechado por esse método, mesmo que as exceções sejam geradas.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Segurança

FileIOPermission
para acesso a 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