TextReader.Read Método

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.IO.dll
Assemblagem:
netstandard.dll

Lê dados do leitor de texto.

Sobrecargas

Name Description
Read()

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

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

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

Read()

Lê o próximo carácter do leitor de texto e avança a posição do carácter 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

Devoluções

Int32

O próximo carácter do leitor de texto, ou -1 se não houver mais caracteres disponíveis. A implementação padrão retorna -1.

Exceções

ObjectDisposedException

Está TextReader fechado.

IOException

Ocorre um erro de E/S.

Observações

A TextReader disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do Read método, veja o StreamReader.Read método.

Ver também

Aplica-se a

Read(Span<Char>)

Lê os caracteres do leitor atual e escreve 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 regressa, contém o espaço especificado de caracteres substituído pelos caracteres lidos da fonte atual.

Devoluções

Int32

O número de caracteres que foram lidos. O número será menor ou igual ao buffer comprimento, dependendo se os dados estão disponíveis no leitor. Este método devolve 0 (zero) se for chamado quando não restam 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 escreve os dados num 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 este método regressa, contém o array de caracteres especificado com os valores entre index e (index + count - 1) substituídos pelos caracteres lidos da fonte atual.

index
Int32

A posição buffer em que começar a escrever.

count
Int32

O número máximo de caracteres para ler. Se o final do leitor for alcançado antes do número especificado de caracteres ser lido no buffer, o método retorna.

Devoluções

Int32

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

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O comprimento do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

Está TextReader fechado.

IOException

Ocorre um erro de E/S.

Observações

Este método retorna depois de os count caracteres serem lidos ou depois de o fim do ficheiro ser alcançado. ReadBlock é uma versão bloqueadora deste método.

A TextReader disciplina é uma disciplina abstrata. Portanto, não o instancias no teu código. Para um exemplo de utilização do Read método, veja o StreamReader.Read método.

Ver também

Aplica-se a