SerialPort.ReadExisting 方法

定义

命名空间:

System.IO.Ports

程序集:

System.IO.Ports.dll

包:

System.IO.Ports v8.0.0

Source:

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