TextReader.Read Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.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()

Origem:

TextReader.cs

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 instanciá-lo em seu código. Para obter um exemplo de como usar o Read método , consulte o StreamReader.Read método .

Confira também

• Read()
• Read()
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Read(Span<Char>)

Origem:

TextReader.cs

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.

Read(Char[], Int32, Int32)

Origem:

TextReader.cs

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 desse método.

A classe TextReader é uma classe abstrata. Portanto, você não instanciá-lo em seu código. Para obter um exemplo de como usar o Read método , consulte o StreamReader.Read método .

Confira também

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo