다음을 통해 공유


SerialPort.ReadByte 메서드

정의

SerialPort 입력 버퍼에서 1바이트를 동기적으로 읽습니다.

public:
 int ReadByte();
public int ReadByte ();
member this.ReadByte : unit -> int
Public Function ReadByte () As Integer

반환

Int32로 캐스팅된 바이트이거나 스트림의 끝을 읽은 경우 -1입니다.

예외

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

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

또는

읽은 바이트가 없는 경우

설명

이 메서드는 1 바이트를 읽습니다.

및 를 ReadChar 함께 사용할 ReadByte 때는 주의해야 합니다. 바이트 읽기와 읽기 문자 간을 전환하면 추가 데이터가 읽기 및/또는 기타 의도하지 않은 동작이 발생할 수 있습니다. 텍스트 읽기와 스트림에서 이진 데이터 읽기 사이를 전환해야 하는 경우 수동으로 바이트 읽기 및 데이터 디코딩과 같이 텍스트와 이진 데이터 간의 경계를 신중하게 정의하는 프로토콜을 선택합니다.

참고

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

적용 대상