TextReader.ReadToEnd Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

TextReader.cs

Lê todos os caracteres da posição atual até o final do leitor de texto e os retorna como uma cadeia de caracteres.

public:
 virtual System::String ^ ReadToEnd();

public virtual string ReadToEnd ();

abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string

Public Overridable Function ReadToEnd () As String

Retornos

String

Uma cadeia de caracteres que contém todos os caracteres da posição atual até o final do leitor de texto.

Exceções

IOException

Ocorre um erro de E/S.

ObjectDisposedException

O TextReader está fechado.

OutOfMemoryException

Não há memória suficiente para alocar um buffer à cadeia de caracteres retornada.

ArgumentOutOfRangeException

O número de caracteres na próxima linha é maior que Int32.MaxValue

Comentários

Se o método gerar uma exceção OutOfMemoryException , a posição do leitor no subjacente Stream será avançada pelo número de caracteres que o método pôde ler, mas os caracteres que já foram lidos no buffer interno ReadToEnd serão descartados. Como a posição do leitor no fluxo não pode ser alterada, os caracteres que já foram lidos são irrecuperáveis e só podem ser acessados reinicializando o TextReader. Se a posição inicial dentro do fluxo for desconhecida ou o fluxo não oferecer suporte à busca, o subjacente Stream também precisará ser reinicializado.

Para evitar essa situação e produzir um código robusto, você deve usar o Read método e armazenar os caracteres de leitura em um buffer preallocado.

A classe TextReader é uma classe abstrata. Portanto, você não instanciá-lo em seu código. Para obter um exemplo de como usar o ReadToEnd método , consulte o StreamReader.ReadToEnd método .

Confira também

• ReadToEnd()
• ReadToEnd()
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo