StreamReader.ReadBlock Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Sobrecargas

ReadBlock(Char[], Int32, Int32)	Lê um máximo especificado de caracteres do fluxo atual e grava os dados em um buffer, começando no índice especificado.
ReadBlock(Span<Char>)	Lê os caracteres do fluxo atual e grava os dados em um buffer.

ReadBlock(Char[], Int32, Int32)

Origem:

StreamReader.cs

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

public:
 override int ReadBlock(cli::array <char> ^ buffer, int index, int count);

public override int ReadBlock (char[] buffer, int index, int count);

override this.ReadBlock : char[] * int * int -> int

Public Overrides Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer

Parâmetros

buffer

Char[]

Quando esse método retorna, 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.

Retornos

Int32

O número de caracteres que foram lidos. O número será menor ou igual a count, dependendo se todos os caracteres de entrada tiverem sido lidos.

Exceções

ArgumentNullException

buffer é null.

ArgumentException

O tamanho do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

ObjectDisposedException

O StreamReader está fechado.

IOException

Ocorreu um erro de E/S.

Comentários

A posição do fluxo subjacente é avançada pelo número de caracteres que foram lidos em buffer.

O método é bloqueado até que os count caracteres sejam lidos ou o final do fluxo seja atingido. Esta é uma versão de bloqueio do Read.

ReadBlock(Span<Char>)

Origem:

StreamReader.cs

Lê os caracteres do fluxo atual e grava os dados em um buffer.

public:
 override int ReadBlock(Span<char> buffer);

public override int ReadBlock (Span<char> buffer);

override this.ReadBlock : Span<char> -> int

Public Overrides Function ReadBlock (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 de buffer, dependendo se todos os caracteres de entrada tiverem sido lidos.

Exceções

ArgumentNullException

buffer é null.

ObjectDisposedException

O StreamReader está fechado.

IOException

Ocorreu um erro de E/S.