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


SerialPort.ReadChar Метод

Определение

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

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

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

Прочитанный символ.

Исключения

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

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

-или-

В течение отведенного срока ожидания не было доступно ни одного символа.

Комментарии

Этот метод считывает один полный символ в зависимости от кодировки.

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

Примечание

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

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