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). Хотя это формально верно, это неэффективно. Любой поток с внутренним буфером должен переопределять этот метод и предоставлять гораздо более эффективную версию, которая считывает буфер напрямую, избегая выделения дополнительных массивов при каждом вызове.