다음을 통해 공유


SerialPort.ReadTo(String) 메서드

정의

입력 버퍼에서 지정된 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

읽기 작업을 중지할 위치를 나타내는 값입니다.

반환

지정된 value까지의 입력 버퍼 내용입니다.

예외

value 매개 변수의 길이가 0인 경우

value 매개 변수가 null인 경우

지정한 포트가 열려 있지 않은 경우

시간 제한이 끝나기 전에 작업이 완료되지 않은 경우

설명

이 메서드는 지정된 value까지 문자열을 읽습니다. 반환된 문자열에는 가 valuevalue 포함되지 않지만 은 입력 버퍼에서 제거됩니다.

텍스트 읽기와 스트림에서 이진 데이터 읽기 간에 전환해야 하는 경우 수동으로 바이트 읽기 및 데이터 디코딩과 같이 텍스트와 이진 데이터 간의 경계를 신중하게 정의하는 프로토콜을 선택합니다.

참고

클래스는 SerialPort 데이터를 버퍼링하고 속성에 BaseStream 포함된 스트림은 그렇지 않으므로 두 클래스는 읽을 수 있는 바이트 수에 대해 충돌할 수 있습니다. 속성은 BytesToRead 읽을 바이트가 있음을 나타낼 수 있지만 이러한 바이트는 클래스에 버퍼링 SerialPort 되었으므로 속성에 포함된 스트림에 BaseStream 액세스할 수 없습니다.

적용 대상