StringReader.ReadToEnd Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.IO.dll
Assemblagem:
netstandard.dll

Lê todos os caracteres desde a posição atual até ao fim da cadeia e devolve-os como uma única cadeia.

public:
 override System::String ^ ReadToEnd();
public override string ReadToEnd();
override this.ReadToEnd : unit -> string
Public Overrides Function ReadToEnd () As String

Devoluções

String

O conteúdo desde a posição atual até ao fim da cadeia subjacente.

Exceções

OutOfMemoryException

Não há memória suficiente para alocar um buffer para a cadeia devolvida.

ObjectDisposedException

O leitor atual está encerrado.

Exemplos

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

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

Observações

Este método sobrepõe-se ao TextReader.ReadToEnd método.

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

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

Para fazer isso... Veja o exemplo neste tópico...
Crie um arquivo de texto. Como: Gravar texto em um arquivo
Escreve num ficheiro de texto. Como: Gravar texto em um arquivo
Lido de um ficheiro de texto. Como: Ler texto de um arquivo
Adicione texto a um ficheiro. Como: Abrir e anexar a um arquivo de log

File.AppendText

FileInfo.AppendText
Obtém o tamanho de um ficheiro. FileInfo.Length
Obtenha as características de um ficheiro. File.GetAttributes
Defina os atributos de um ficheiro. File.SetAttributes
Determina se existe um ficheiro. File.Exists
Lê a partir de um ficheiro binário. Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário. Como: Ler e gravar em um arquivo de dados recém-criado

Aplica-se a

Ver também