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

MemoryStream.Read 메서드

2013-12-13

현재 스트림에서 바이트 블록을 읽어서 데이터를 버퍼에 기록합니다.

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

public override 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이 될 수도 있습니다.

예외조건
ArgumentNullException

buffernull인 경우

ArgumentOutOfRangeException

offset 또는 count가 음수인 경우

ArgumentException

버퍼 길이에서 offset을 빼면 count보다 작은 경우

ObjectDisposedException

현재 스트림 인스턴스가 닫혀 있는 경우

이 메서드는 Read를 재정의합니다.

offset 매개 변수는 현재 스트림의 데이터를 쓴 buffer에 있는 첫 번째 바이트의 오프셋을 제공합니다. count 매개 변수는 현재 스트림에서 읽은 최대 바이트 수를 제공합니다. 반환되는 값은 실제 읽은 바이트 수입니다. 스트림의 끝에 도달한 경우에는 0입니다.

읽기 작업이 성공적으로 수행되면 스트림 내의 현재 위치는 읽은 바이트 수만큼 앞으로 이동합니다. 예외가 발생하면 스트림 내의 현재 위치는 변경되지 않습니다.

Read 메서드는 스트림의 끝에 도달한 경우에만 0을 반환합니다. 다른 모든 경우에 Read는 반환하기 전에 항상 스트림에서 1바이트 이상을 읽습니다. Read 호출 시 스트림에서 읽을 데이터가 없는 경우 Read 메서드는 0을 반환(스트림의 끝에 자동으로 도달함)하도록 정의되어 있습니다. 이 메서드를 구현하면 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트가 반환될 수 있습니다.

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

주의주의:

buffer 매개 변수에 지정된 바이트 배열이 GetBuffer 메서드에서 반환된 내부 버퍼이면 배열 내용을 덮어쓰고 예외가 발생하지 않습니다.

Windows Phone OS

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

Windows Phone

표시: