Stream.ReadByte Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.IO.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
Stream.cs
Исходный код:
Stream.cs
Исходный код:
Stream.cs

Считывает байт из потока и перемещает позицию в потоке на один байт или возвращает -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

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

Исключения

NotSupportedException

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

ObjectDisposedException

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

Комментарии

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

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

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

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

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

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