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 .