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


Stream.ReadByte Метод

Определение

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

public:
 virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

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

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

Исключения

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

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

Комментарии

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

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

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

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

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

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