SerialPort.ReadChar Метод

Определение

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

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

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

SerialPort.cs

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

public:
 int ReadChar();

public int ReadChar ();

member this.ReadChar : unit -> int

Public Function ReadChar () As Integer

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

Int32

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

Исключения

InvalidOperationException

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

TimeoutException

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

-или-

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

Комментарии

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

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

Примечание

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