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

UnmanagedMemoryStream.Read 메서드

2013-12-13

이 API는 .NET Framework 인프라를 지원하며 사용자 코드에서 직접 사용할 수 없습니다.

지정된 바이트 수를 지정된 배열로 읽어들입니다.

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이 됩니다.

예외조건
ObjectDisposedException

스트림이 닫혀 있는 경우

NotSupportedException

내부 메모리가 읽기를 지원하지 않는 경우

-또는-

CanRead 속성이 false로 설정된 경우

ArgumentNullException

buffer 매개 변수가 null로 설정된 경우

ArgumentOutOfRangeException

offset 매개 변수가 0보다 작은 경우

-또는-

count 매개 변수가 0보다 작은 경우

ArgumentException

버퍼 배열 길이에서 offset 매개 변수를 뺀 값이 count 매개 변수보다 작은 경우

offset 매개 변수는 읽기를 시작할 array 매개 변수(버퍼 인덱스)의 바이트 오프셋을 제공하며 count 매개 변수는 이 스트림에서 읽을 최대 바이트 수를 제공합니다. 반환되는 값은 실제 읽은 바이트 수입니다. 스트림의 끝에 도달한 경우에는 0입니다. 읽기 작업이 정상적으로 수행되면 스트림의 현재 위치는 읽은 바이트 수만큼 앞으로 이동합니다. 예외가 발생하면 스트림의 현재 위치는 변경되지 않습니다.

Read 메서드는 스트림의 끝에 도달한 후에만 0을 반환합니다. 그렇지 않으면 Read는 반환하기 전에 항상 스트림에서 1바이트 이상을 읽습니다. Read를 호출할 때 스트림에서 데이터를 사용할 수 없으면 해당 메서드는 1바이트 이상의 데이터를 반환할 수 있을 때까지 차단시킵니다. 이 메서드를 구현하면 스트림의 끝에 도달하지 않은 경우에도 요청된 것보다 적은 바이트가 반환될 수 있습니다.

Windows Phone OS

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

Windows Phone

표시: