StringReader.ReadLine Método

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

public override string ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Devoluções

A linha seguinte da corda atual, ou null se o fim da corda for alcançado.

Exceções

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, 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)

Observações

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

Uma linha é definida como uma sequência de caracteres seguida por um avanço de linha ("\n"), um retorno de carro ("\r"), um retorno de carro imediatamente seguido por um avanço de linha ("\r\n"), ou o marcador de fim de fluxo. A cadeia que é devolvida não contém o retorno do carro de terminação nem o avanço da linha. O valor devolvido é null se o marcador de fim de fluxo foi atingido. Ou seja, se não houver nada entre a última linha lida e o marcador de fim de fluxo, o método devolve null.

Se a cadeia terminar com uma sequência de nova linha, não é retornada nenhuma linha vazia adicional. Por exemplo, a corda "line1\nline2\n" produz as mesmas duas linhas ("line1" e "line2") que a corda "line1\nline2".

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 ReadLine 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.

Ver também

• E/S de arquivo e fluxo
• Como: Ler texto de um arquivo
• Como: Gravar texto em um arquivo