TextReader.ReadBlock Método

Definição

Namespace:

System.IO

Assembly:

System.IO.dll

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Sobrecargas

ReadBlock(Char[], Int32, Int32)	Lê um máximo especificado de caracteres do leitor de texto 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)

Lê um máximo especificado de caracteres do leitor de texto atual e grava os dados em um 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 esse método retorna, este parâmetro 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 TextReader está fechado.

IOException

Ocorre um erro de E/S.

Comentários

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

O método bloqueia até que ambos os count caracteres sejam lidos ou todos os caracteres tenham sido lidos. Esta é uma versão de bloqueio de Read.

Confira também

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

ReadBlock(Span<Char>)

Lê os caracteres do fluxo atual e grava os dados em um 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

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.