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 0보다 큽니다.

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

참고

클래스는 SerialPort 데이터를 버퍼링하지만 속성에 포함된 스트림 개체는 SerialPort.BaseStream 데이터를 버퍼링하지 않습니다. 따라서 SerialPort 개체와 스트림 개체는 읽을 수 있는 바이트 수에 따라 다를 수 있습니다. 바이트가 개체 BytesToRead 에 SerialPort 버퍼링되면 속성 값에 이러한 바이트가 포함되지만 이러한 바이트는 속성에 포함된 스트림에 BaseStream 액세스할 수 없을 수 있습니다.