StringReader.ReadToEnd Método

Definição

Lê todos os caracteres da posição atual até o final da cadeia de caracteres e os retorna como uma única cadeia de caracteres.Reads all characters from the current position to the end of the string and returns them as a single string.

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.The content from the current position to the end of the underlying string.

Exceções

Não há memória suficiente para alocar um buffer à cadeia de caracteres retornada.There is insufficient memory to allocate a buffer for the returned string.

O leitor atual está fechado.The current reader is closed.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a TextReader classe.This code example is part of a larger example provided for the TextReader class.

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.This method overrides the TextReader.ReadToEnd method.

Se o método atual lançar um OutOfMemoryException , a posição do leitor na cadeia de caracteres subjacente será avançada pelo número de caracteres que o método foi capaz de ler, mas os caracteres já lidos no ReadToEnd buffer interno serão descartados.If the current method throws an OutOfMemoryException, the reader's position in the underlying string is advanced by the number of characters the method was able to read, but the characters already read into the internal ReadToEnd buffer are discarded. Como a posição do leitor na cadeia de caracteres não pode ser alterada, os caracteres já lidos são irrecuperáveis e podem ser acessados apenas pela reinicialização do StringReader .Because the position of the reader in the string cannot be changed, the characters already read are unrecoverable, and can be accessed only by reinitializing the StringReader. Para evitar essa situação, use o Read método e armazene os caracteres de leitura em um buffer pré-alocado.To avoid such a situation, use the Read method and store the read characters in a preallocated buffer.

A tabela a seguir lista exemplos de outras tarefas de e/s típicas ou relacionadas.The following table lists examples of other typical or related I/O tasks.

Para fazer isso...To do this... Veja o exemplo neste tópico...See the example in this topic...
Crie um arquivo de texto.Create a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Gravar em um arquivo de texto.Write to a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Ler de um arquivo de texto.Read from a text file. Como ler texto de um arquivoHow to: Read Text from a File
Acrescentar texto a um arquivo.Append text to a file. Como abrir e acrescentar a um arquivo de logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obter o tamanho de um arquivo.Get the size of a file. FileInfo.Length
Obter os atributos de um arquivo.Get the attributes of a file. File.GetAttributes
Defina os atributos de um arquivo.Set the attributes of a file. File.SetAttributes
Determine se um arquivo existe.Determine if a file exists. File.Exists
Ler de um arquivo binário.Read from a binary file. Como ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File
Gravar em um arquivo binário.Write to a binary file. Como: Ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File

Aplica-se a