TextReader.ReadBlock Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

Перегрузки

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

ReadBlock(Char[], Int32, Int32)

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

TextReader.cs

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

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

Параметры

buffer

Char[]

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

index

Int32

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

count

Int32

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

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

Int32

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

Исключения

ArgumentNullException

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

ArgumentException

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

ArgumentOutOfRangeException

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

ObjectDisposedException

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

IOException

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

Комментарии

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

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

См. также раздел

• ReadBlock(Char[], Int32, Int32)
• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл

ReadBlock(Span<Char>)

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

TextReader.cs

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

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

Параметры

buffer

Span<Char>

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

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

Int32

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

Исключения

ArgumentNullException

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

ObjectDisposedException

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

IOException

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