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

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


Stream.ReadByte Метод

Определение

Считывает байт из потока и перемещает позицию в потоке на один байт или возвращает -1, если достигнут конец потока.

C#
public virtual int ReadByte ();

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

Байт без знака, приведенный к Int32, или значение -1, если достигнут конец потока.

Исключения

Поток не поддерживает чтение.

Методы были вызваны после закрытия потока.

Комментарии

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

Попытки управлять потоком после закрытия потока могут вызвать исключение ObjectDisposedException.

Примечания для тех, кто наследует этот метод

Реализация по умолчанию в Stream создает новый однобайтовый массив, а затем вызывает Read(Byte[], Int32, Int32). Хотя это формально верно, это неэффективно. Любой поток с внутренним буфером должен переопределять этот метод и предоставлять гораздо более эффективную версию, которая считывает буфер напрямую, избегая выделения дополнительных массивов при каждом вызове.

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

Продукт Версии
.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 1.1, 2.0, 3.0, 3.5, 4.0, 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

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