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


SerialPort.ReadByte Метод

Определение

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

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

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

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

Исключения

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

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

-или-

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

Комментарии

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

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

Примечание

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

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