Прочитать на английском

Поделиться через


StreamReader.ReadBlock Метод

Определение

Перегрузки

ReadBlock(Char[], Int32, Int32)

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

ReadBlock(Span<Char>)

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

ReadBlock(Char[], Int32, Int32)

Исходный код:
StreamReader.cs
Исходный код:
StreamReader.cs
Исходный код:
StreamReader.cs

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

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

Параметры

buffer
Char[]

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

index
Int32

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

count
Int32

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

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

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

Исключения

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

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

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

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ReadBlock(Span<Char>)

Исходный код:
StreamReader.cs
Исходный код:
StreamReader.cs
Исходный код:
StreamReader.cs

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

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

Параметры

buffer
Span<Char>

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

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

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

Исключения

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

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1