StringReader.ReadToEnd Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

StringReader.cs

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

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

public override string ReadToEnd ();

override this.ReadToEnd : unit -> string

Public Overrides Function ReadToEnd () As String

Retornos

String

O conteúdo da posição atual até o final da cadeia de caracteres subjacente.

Exceções

OutOfMemoryException

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

ObjectDisposedException

O leitor atual está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a TextReader classe .

void ReadText( TextReader^ textReader )
{
   Console::WriteLine( "From {0} - {1}", textReader->GetType()->Name, textReader->ReadToEnd() );
}

static void ReadText(TextReader textReader)
{
    Console.WriteLine("From {0} - {1}",
        textReader.GetType().Name, textReader.ReadToEnd());
}

Shared Sub ReadText(aTextReader As TextReader)
    Console.WriteLine("From {0} - {1}", _
        aTextReader.GetType().Name, aTextReader.ReadToEnd())
End Sub

Comentários

Esse método substitui o TextReader.ReadToEnd método .

Se o método atual gerar um OutOfMemoryException, a posição do leitor na cadeia de caracteres subjacente será avançada pelo número de caracteres que o método conseguiu ler, mas os caracteres já lidos no buffer interno ReadToEnd serão descartados. Como a posição do leitor na cadeia de caracteres não pode ser alterada, os caracteres já lidos são irrecuperáveis e só podem ser acessados reinicializando o StringReader. Para evitar essa situação, use o Read método e armazene os caracteres de leitura em um buffer pré-alocado.

A tabela a seguir lista exemplos de outras tarefas de E/S típicas ou relacionadas.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como gravar texto em um arquivo
Gravar em um arquivo de texto.	Como gravar texto em um arquivo
Ler de um arquivo de texto.	Como ler texto de um arquivo
Acrescente texto a um arquivo.	Como abrir e acrescentar a um arquivo de log File.AppendText FileInfo.AppendText
Obter o tamanho de um arquivo.	FileInfo.Length
Obter os atributos de um arquivo.	File.GetAttributes
Defina os atributos de um arquivo.	File.SetAttributes
Determine se existe um arquivo.	File.Exists
Ler de um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado
Gravar em um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado

Confira também

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