Compartilhar via


StringReader.ReadLine Método

Definição

Lê uma linha de caracteres da cadeia de caracteres atual e retorna os dados como uma cadeia de caracteres.

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

Retornos

A próxima linha da cadeia de caracteres atual, ou null, se o final da cadeia de caracteres for atingido.

Exceções

O leitor atual está fechado.

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

Exemplos

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

// From textReaderText, create a continuous paragraph 
// with two spaces between each sentence.
   String^ aLine;
String^ aParagraph;
StringReader^ strReader = gcnew StringReader( textReaderText );
while ( true )
{
   aLine = strReader->ReadLine();
   if ( aLine != nullptr )
   {
      aParagraph = String::Concat( aParagraph, aLine,  " " );
   }
   else
   {
      aParagraph = String::Concat( aParagraph,  "\n" );
      break;
   }
}

Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );
// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
    aLine = strReader.ReadLine();
    if(aLine != null)
    {
        aParagraph = aParagraph + aLine + " ";
    }
    else
    {
        aParagraph = aParagraph + "\n";
        break;
    }
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);
' From textReaderText, create a continuous paragraph 
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
    aLine = strReader.ReadLine()
    If aLine Is Nothing Then
        aParagraph = aParagraph & vbCrLf
        Exit While
    Else
        aParagraph = aParagraph & aLine & " "
    End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
    aParagraph)

Comentários

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

Uma linha é definida como uma sequência de caracteres seguida por um feed de linha ("\n"), um retorno de carro ("\r"), um retorno de carro imediatamente seguido por um feed de linha ("\r\n" ou o marcador de fim de fluxo. A cadeia de caracteres retornada não contém o retorno de carro de terminação ou o feed de linha. O valor retornado será null se o marcador de fim de fluxo tiver sido atingido. Ou seja, se não houver nada entre a última linha lida e o marcador de fim de fluxo, o método retornará null.

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 pôde ler, mas os caracteres já lidos no buffer interno ReadLine 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 o texto a um arquivo. Como abrir e acrescentar a um arquivo de log

File.AppendText

FileInfo.AppendText
Obtenha o tamanho de um arquivo. FileInfo.Length
Obtenha 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

Aplica-se a

Confira também