TextReader.Read Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Lê dados do leitor de texto.

Sobrecargas

Read()

Lê o próximo caractere do leitor de texto e avança a posição do caractere em um caractere.
Read(Span<Char>)

Lê os caracteres do leitor atual e grava os dados no buffer especificado.
Read(Char[], Int32, Int32)

Lê um número máximo especificado de caracteres do leitor atual e grava os dados em um buffer, começando no índice especificado.

Read()

Lê o próximo caractere do leitor de texto e avança a posição do caractere em um caractere.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

Retornos

Int32

O próximo caractere do leitor de texto ou -1 se não houver mais nenhum caractere disponível. A implementação padrão retorna -1.

Exceções

ObjectDisposedException

O TextReader está fechado.

IOException

Ocorre um erro de E/S.

Comentários

A classe TextReader é uma classe abstrata. Portanto, você não a instancia em seu código. Para obter um exemplo de uso do Read método, consulte o StreamReader.Read método.

Confira também

Aplica-se a

Read(Span<Char>)

Lê os caracteres do leitor atual e grava os dados no buffer especificado.

public:
 virtual int Read(Span<char> buffer);
public virtual int Read (Span<char> buffer);
abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int
Public Overridable Function Read (buffer As Span(Of Char)) As Integer

Parâmetros

buffer
Span<Char>

Quando este método é retornado, contém o intervalo de caracteres especificado substituídos pelos caracteres lidos da origem atual.

Retornos

Int32

O número de caracteres que foram lidos. O número será menor ou igual ao comprimento do buffer, dependendo da disponibilidade dos dados no leitor. Esse método retornará 0 (zero) se for chamado quando não houver mais caracteres para ler.

Exceções

ArgumentNullException

buffer é null.

IOException

O número de caracteres lidos do fluxo é maior do que o comprimento do buffer.

Aplica-se a

Read(Char[], Int32, Int32)

Lê um número máximo especificado de caracteres do leitor atual e grava os dados em um buffer, começando no índice especificado.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);
public virtual int Read (char[] buffer, int index, int count);
abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int
Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parâmetros

buffer
Char[]

Quando esse método é retornado, contém a matriz de caracteres especificada com os valores entre index e (index + count – 1) substituídos pelos caracteres lidos da origem atual.

index
Int32

A posição em buffer na qual a gravação será iniciada.

count
Int32

O número máximo de caracteres a serem lidos. Se o final do leitor for atingido antes que o número especificado de caracteres seja lido no buffer, o método será retornado.

Retornos

Int32

O número de caracteres que foram lidos. O número será menor ou igual a count, dependendo se os dados estão disponíveis no leitor. Esse método retornará 0 (zero) se for chamado quando não houver mais caracteres para ler.

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O tamanho do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O TextReader está fechado.

IOException

Ocorre um erro de E/S.

Comentários

Esse método retorna depois que os caracteres count são lidos ou o final do arquivo é atingido. ReadBlock é uma versão de bloqueio deste método.

A classe TextReader é uma classe abstrata. Portanto, você não a instancia em seu código. Para obter um exemplo de uso do Read método, consulte o StreamReader.Read método.

Confira também

Aplica-se a