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 流可能无法访问这些字节。

适用于