TextReader.ReadLine Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê uma linha de caracteres do leitor de texto e retorna os dados como uma cadeia de caracteres.
public:
virtual System::String ^ ReadLine();public virtual string ReadLine();public virtual string? ReadLine();abstract member ReadLine : unit -> string
override this.ReadLine : unit -> stringPublic Overridable Function ReadLine () As StringRetornos
A próxima linha do leitor ou null se todos os caracteres foram lidos.
Exceções
Ocorre um erro de E/S.
Não há memória suficiente para alocar um buffer para a cadeia de caracteres retornada.
O TextReader está fechado.
O número de caracteres na próxima linha é maior que Int32.MaxValue
Comentários
Uma linha é definida como uma sequência de caracteres seguida por um retorno de carro (0x000d), um feed de linha (0x000a), um retorno de carro seguido por um feed Environment.NewLinede linha ou o final da entrada do leitor. 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 final da entrada tiver sido atingido.
Se a entrada terminar com uma nova sequência de linhas, nenhuma linha vazia adicional será retornada. Por exemplo, a entrada que "line1\nline2\n" contém produz as mesmas duas linhas ("line1" e "line2") que a entrada que contém "line1\nline2".
Se o método gerar uma OutOfMemoryException exceção, a posição do leitor em sua fonte subjacente será avançada pelo número de caracteres que o método pôde ler, mas os caracteres que já foram lidos no buffer interno ReadLine serão descartados. Como a posição do leitor na origem subjacente não pode ser redefinida, os caracteres que já foram lidos são irrecuperáveis e só podem ser acessados reinicializando o TextReader objeto. Se a posição inicial dentro da fonte subjacente for desconhecida ou a origem não oferecer suporte ao repositório, a fonte subjacente também precisará ser reinicializada.
Para evitar essa situação e produzir um código robusto, você deve usar o Read método e armazenar os caracteres de leitura em um buffer pré-alocado.
A TextReader classe é uma classe abstrata. Portanto, você não instanciá-lo em seu código. Para obter um exemplo de como usar o ReadLine método, consulte o StreamReader.ReadLine método.
