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


SerialPort.ReadExisting Метод

Определение

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

public:
 System::String ^ ReadExisting();
public string ReadExisting ();
member this.ReadExisting : unit -> string
Public Function ReadExisting () As String

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

Содержимое потока и входного буфера объекта SerialPort.

Исключения

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

Комментарии

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

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

Примечание

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

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