BufferedStream.ReadByte Метод

Определение

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

System.IO

Сборка:

System.Runtime.dll

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

BufferedStream.cs

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

public:
 override int ReadByte();

public override int ReadByte ();

override this.ReadByte : unit -> int

Public Overrides Function ReadByte () As Integer

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

Int32

Байт, приведенный к int, или значение -1 при попытке чтения из конца потока.

Исключения

IOException

Ошибка ввода-вывода, например указывающая, что поток закрыт.

NotSupportedException

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

ObjectDisposedException

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

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

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

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

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл