Partilhar via


TextReader.ReadToEnd Método

Definição

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

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

Exceções

Ocorre um erro de E/S.

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

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 .

Aplica-se a

Confira também