StreamReader.ReadBlock Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

ReadBlock(Char[], Int32, Int32)	Считывает указанное максимальное количество символов из текущего потока и записывает данные в буфер, начиная с заданного индекса.
ReadBlock(Span<Char>)	Считывает символы из текущего потока и записывает данные в буфер.

ReadBlock(Char[], Int32, Int32)

Исходный код:

StreamReader.cs

Считывает указанное максимальное количество символов из текущего потока и записывает данные в буфер, начиная с заданного индекса.

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

Параметры

buffer

Char[]

При возврате данный метод содержит указанный массив символов, в котором значения в интервале между index и (index + count - 1) заменены символами, считанными из текущего источника.

index

Int32

Позиция в буфере buffer, с которого начинается запись.

count

Int32

Максимальное число считываемых символов.

Возвращаемое значение

Int32

Количество считанных символов. Число будет меньше или равно значению count, в зависимости от того, считаны ли все входящие символы.

Исключения

ArgumentNullException

buffer имеет значение null.

ArgumentException

Длина буфера минус index меньше count.

ArgumentOutOfRangeException

index или count является отрицательным значением.

ObjectDisposedException

Объект StreamReader закрыт.

IOException

Ошибка ввода/вывода.

Комментарии

Позиция базового потока расширена по количеству символов, которые были считаны в buffer.

Метод блокируется до тех пор, пока не будут считаны символы count или не будет достигнут конец потока. Это блокирующая версия Read.

ReadBlock(Span<Char>)

Исходный код:

StreamReader.cs

Считывает символы из текущего потока и записывает данные в буфер.

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

Параметры

buffer

Span<Char>

При возврате этого метода содержит указанный диапазон символов, в котором значения заменены символами, считанными из текущего источника.

Возвращаемое значение

Int32

Количество считанных символов. Это число будет не больше длины buffer в зависимости от того, считаны ли все входящие символы.

Исключения

ArgumentNullException

buffer имеет значение null.

ObjectDisposedException

Объект StreamReader закрыт.

IOException

Ошибка ввода/вывода.