정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Stream.Read 메서드

2013-12-13

파생 클래스에서 재정의된 경우 현재 스트림에서 바이트의 시퀀스를 읽고 읽은 바이트 수만큼 스트림 내에서 앞으로 이동합니다.

Namespace:  System.IO
어셈블리:  mscorlib(mscorlib.dll)

public abstract int Read(
	byte[] buffer,
	int offset,
	int count
)

매개 변수

buffer
형식: System.Byte []
바이트 배열입니다. 이 메서드가 반환될 때 버퍼에는 지정된 바이트 배열의 값이 offset 및 (offset + count - 1) 사이에서 현재 소스로부터 읽어온 바이트로 교체된 상태로 포함됩니다.
offset
형식: System.Int32
현재 스트림에서 읽은 데이터를 저장하기 시작하는 buffer의 바이트 오프셋(0부터 시작)입니다.
count
형식: System.Int32
현재 스트림에서 읽을 최대 바이트 수입니다.

반환 값

형식: System.Int32
버퍼로 읽어온 총 바이트 수입니다. 이 바이트 수는 현재 바이트가 충분하지 않은 경우 요청된 바이트 수보다 작을 수 있으며 스트림의 끝에 도달하면 0이 됩니다.

예외조건
ArgumentException

offsetcount의 합계가 버퍼 길이보다 큰 경우

ArgumentNullException

buffernull인 경우

ArgumentOutOfRangeException

offset 또는 count가 음수인 경우

IOException

I/O 오류가 발생하는 경우

NotSupportedException

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

ObjectDisposedException

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

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

이 메서드를 구현하면 현재 스트림에서 최대 count 바이트를 읽어 offset에서 시작하는 buffer에 저장합니다. 스트림 내의 현재 위치는 읽은 바이트 수만큼 앞으로 이동하지만 예외가 발생하는 경우 스트림 내의 현재 위치는 변경되지 않습니다. 이 메서드를 구현하면 읽은 바이트 수가 반환됩니다. 반환 값은 현재 위치가 스트림의 끝에 있는 경우에만 0입니다. 구현은 사용가능한 데이터가 없는 경우 적어도 1바이트의 데이터를 읽을 수 있을 때까지 차단됩니다. Read는 스트림에 데이터가 더 이상 없고 예상되는 데이터도 더 이상 없는 경우에만 0을 반환합니다(예: 닫힌 소켓 또는 파일의 끝). 이 메서드를 구현하면 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트가 반환될 수 있습니다.

BinaryReader를 사용하여 기본 데이터 형식을 읽습니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: