SerialPort.ReadByte Метод

Определение

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

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

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

SerialPort.cs

Считывает из входного буфера SerialPort один байт в синхронном режиме.

public:
 int ReadByte();

public int ReadByte ();

member this.ReadByte : unit -> int

Public Function ReadByte () As Integer

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

Int32

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

Исключения

InvalidOperationException

Указанный порт не открыт.

TimeoutException

Операция не была завершена до истечения срока ожидания.

-или-

Не считано ни одного байта.

Комментарии

Этот метод считывает один байт.

Соблюдайте осторожность при совместном использовании ReadByte и ReadChar . Переключение между чтением байтов и чтением символов может привести к чтению дополнительных данных и (или) другому непреднамеренное поведение. Если необходимо переключаться между чтением текста и двоичными данными из потока, выберите протокол, который тщательно определяет границу между текстовыми и двоичными данными, например чтение байтов вручную и декодирование данных.

Примечание

SerialPort Так как класс буферизует данные, а поток, содержащийся в BaseStream свойстве, — нет, они могут конфликтовать о том, сколько байтов доступно для чтения. Свойство BytesToRead может указывать на то, что есть байты для чтения, но эти байты могут быть недоступны для потока, содержащегося в свойстве BaseStream , так как они были помещены в буфер в SerialPort класс .