SerialPort.ReadTo(String) 方法

定义

命名空间:

System.IO.Ports

程序集:

System.IO.Ports.dll

包:

System.IO.Ports v8.0.0

Source:

SerialPort.cs

一直读取到输入缓冲区中的指定 value 的字符串。

public:
 System::String ^ ReadTo(System::String ^ value);

public string ReadTo (string value);

member this.ReadTo : string -> string

Public Function ReadTo (value As String) As String

参数

value

String

指示读取操作停止位置的值。

返回

String

输入缓冲区中直到指定 value 的内容。

例外

ArgumentException

value 参数的长度为 0。

ArgumentNullException

value 参数为 null。

InvalidOperationException

指定的端口未打开。

TimeoutException

该操作未在超时时间到期之前完成。

注解

此方法读取一个字符串，一直读取到指定的 value。 虽然返回的字符串不包括 value， value 但 会从输入缓冲区中删除 。

如果需要在读取文本和从流中读取二进制数据之间切换，请选择一个协议来仔细定义文本和二进制数据之间的边界，例如手动读取字节和解码数据。

注意

SerialPort由于 类缓冲数据，而 属性中包含的BaseStream流不缓冲数据，因此两者在可用于读取的字节数方面可能会发生冲突。 属性 BytesToRead 可以指示存在要读取的字节，但属性中包含的 BaseStream 流可能无法访问这些字节，因为它们已缓冲到 SerialPort 类。