SerialPort.ReadExisting Метод

Определение

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

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

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

SerialPort.cs

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

public:
 System::String ^ ReadExisting();

public string ReadExisting ();

member this.ReadExisting : unit -> string

Public Function ReadExisting () As String

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

String

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

Исключения

InvalidOperationException

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

Комментарии

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

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

Примечание

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