Stream.ReadByte 메서드

정의

스트림에서 바이트를 읽고 스트림 내 위치를 한 바이트씩 앞으로 이동하거나 스트림 끝일 경우 -1을 반환합니다.Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.

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

반환

Int32

Int32로 캐스팅된 부호 없는 바이트이거나 스트림의 끝에 있는 경우 -1입니다.The unsigned byte cast to an Int32, or -1 if at the end of the stream.

예외

스트림이 읽기를 지원하지 않습니다.The stream does not support reading.

스트림이 닫힌 후에 메서드가 호출되었습니다.Methods were called after the stream was closed.

설명

CanRead현재 인스턴스에서 읽기를 지원 하는지 여부를 확인 하려면 속성을 사용 합니다.Use the CanRead property to determine whether the current instance supports reading.

스트림이 닫힌 후 스트림을 조작 하려고 하면이 throw 될 수 있습니다 ObjectDisposedException .Attempts to manipulate the stream after the stream has been closed could throw an ObjectDisposedException.

상속자 참고

의 기본 구현은 Stream 새 싱글바이트 배열을 만든 다음를 호출 Read(Byte[], Int32, Int32) 합니다.The default implementation on Stream creates a new single-byte array and then calls Read(Byte[], Int32, Int32). 이는 공식적으로 올바르지만 비효율적입니다.While this is formally correct, it is inefficient. 내부 버퍼가 있는 스트림은이 메서드를 재정의 하 고, 모든 호출에 대 한 추가 배열 할당을 방지 하 여 버퍼를 직접 읽는 훨씬 더 효율적인 버전을 제공 해야 합니다.Any stream with an internal buffer should override this method and provide a much more efficient version that reads the buffer directly, avoiding the extra array allocation on every call.

적용 대상

추가 정보