TextReader.ReadBlock Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| ReadBlock(Span<Char>) |
Lê os caracteres do fluxo atual e escreve os dados num buffer. |
| ReadBlock(Char[], Int32, Int32) |
Lê um número máximo especificado de caracteres do leitor de texto atual e escreve os dados num buffer, começando no índice especificado. |
ReadBlock(Span<Char>)
Lê os caracteres do fluxo atual e escreve os dados num buffer.
public:
virtual int ReadBlock(Span<char> buffer);
public virtual int ReadBlock(Span<char> buffer);
abstract member ReadBlock : Span<char> -> int
override this.ReadBlock : Span<char> -> int
Public Overridable Function ReadBlock (buffer As Span(Of Char)) As Integer
Parâmetros
Quando este método regressa, contém o espaço especificado de caracteres substituído pelos caracteres lidos da fonte atual.
Devoluções
O número de caracteres que foram lidos. O número será menor ou igual ao buffer comprimento, dependendo de todos os caracteres de entrada terem sido lidos.
Exceções
buffer é null.
Está StreamReader fechado.
Ocorreu um erro de I/O.
Aplica-se a
ReadBlock(Char[], Int32, Int32)
Lê um número máximo especificado de caracteres do leitor de texto atual e escreve os dados num buffer, começando no índice especificado.
public:
virtual int ReadBlock(cli::array <char> ^ buffer, int index, int count);
public virtual int ReadBlock(char[] buffer, int index, int count);
abstract member ReadBlock : char[] * int * int -> int
override this.ReadBlock : char[] * int * int -> int
Public Overridable Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer
Parâmetros
- buffer
- Char[]
Quando este método regressa, este parâmetro 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.
Devoluções
O número de caracteres que foram lidos. O número será menor ou igual a count, dependendo de todos os caracteres de entrada terem sido lidos.
Exceções
buffer é null.
O comprimento do buffer menos index é menor que count.
index ou count é negativo.
Está TextReader fechado.
Ocorre um erro de E/S.
Observações
A posição do leitor de texto subjacente é avançada pelo número de caracteres que foram lidos em buffer.
O método bloqueia até que os count caracteres sejam lidos, ou até que todos os caracteres tenham sido lidos. Esta é uma versão bloqueante de Read.
Ver também
- ReadBlock(Char[], Int32, Int32)
- E/S de arquivo e fluxo
- Como: Ler texto de um arquivo
- Como: Gravar texto em um arquivo