SerialPort.ReadTo(String) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

一直读取到输入缓冲区中的指定 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 的内容。

value 参数的长度为 0。

value 参数为 null。

指定的端口未打开。

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

此方法将读取一个字符串，最多读取指定的 value字符串。虽然返回的字符串不包含该 value字符串，但 value 将从输入缓冲区中删除该字符串。

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

备注

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