다음을 통해 공유


Stream.ReadByte 메서드

스트림에서 바이트를 읽고 스트림 내 위치를 한 바이트씩 앞으로 이동하거나 스트림 끝일 경우 -1을 반환합니다.

네임스페이스: System.IO
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public Overridable Function ReadByte As Integer
‘사용 방법
Dim instance As Stream
Dim returnValue As Integer

returnValue = instance.ReadByte
public virtual int ReadByte ()
public:
virtual int ReadByte ()
public int ReadByte ()
public function ReadByte () : int

반환 값

Int32로 캐스팅된 부호 없는 바이트이거나 스트림의 끝에 있는 경우 바이트 수는 -1입니다.

예외

예외 형식 조건

NotSupportedException

스트림이 읽기를 지원하지 않는 경우

ObjectDisposedException

스트림이 닫힌 후 메서드가 호출된 경우

설명

파일을 만들고 파일에 텍스트를 쓰는 방법에 대한 예제를 보려면 방법: 파일에 텍스트 쓰기를 참조하십시오. 파일에서 텍스트를 읽는 방법에 대한 예제를 보려면 방법: 파일의 텍스트 읽기를 참조하십시오. 이진 파일을 읽거나 쓰는 방법에 대한 예제를 보려면 방법: 새로 만든 데이터 파일 읽기 및 쓰기를 참조하십시오.

현재 인스턴스가 읽기를 지원하는지 여부를 결정하려면 CanRead 속성을 사용합니다.

스트림이 닫힌 후 스트림을 조작하려고 하면 ObjectDisposedException이 throw될 수 있습니다.

구현자 참고 사항 기본적으로 Stream을 구현하면 새로운 단일 바이트 배열이 만들어진 다음 Read가 호출됩니다. 이것은 형식적으로는 올바르지만 비효율적입니다. 스트림이 내부 버퍼를 사용하는 경우에는 이를 직접 읽도록 해당 메서드를 재정의함으로써 메서드가 호출될 때마다 별도의 배열이 할당되지 않도록 하는 것이 보다 효율적입니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

Stream 클래스
Stream 멤버
System.IO 네임스페이스

기타 리소스

파일 및 스트림 I/O
방법: 파일의 텍스트 읽기
방법: 파일에 텍스트 쓰기