MSDN Library
콘텐츠의 테이블 축소
콘텐츠의 테이블 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Stream.ReadAsync 메서드 (Byte[], Int32, Int32)

2013-12-13

현재 스트림에서 바이트 시퀀스를 비동기적으로 읽고 읽은 바이트 수만큼 스트림에서 위치를 앞으로 이동합니다.

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

public Task<int> ReadAsync(
	byte[] buffer,
	int offset,
	int count
)

매개 변수

buffer
형식: System.Byte []
데이터를 쓸 버퍼입니다.
offset
형식: System.Int32
스트림에서 데이터를 쓰기 시작할 buffer의 바이트 오프셋입니다.
count
형식: System.Int32
읽을 최대 바이트 수입니다.

반환 값

형식: System.Threading.Tasks.Task<Int32>
비동기 읽기 작업을 나타내는 작업입니다. TResult 매개 변수 값에는 버퍼로 읽어온 총 바이트 수가 포함됩니다. 현재 사용 가능한 바이트 수가 요청된 수보다 작으면 결과 값은 요청된 바이트 수보다 작을 수 있고, 스트림 끝에 도달한 경우 0일 수 있습니다.

예외조건
ArgumentNullException

buffernull인 경우

ArgumentOutOfRangeException

offset 또는 count가 음수인 경우

ArgumentException

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

NotSupportedException

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

ObjectDisposedException

스트림이 삭제된 경우

InvalidOperationException

스트림이 현재 이전 읽기 작업에서 사용 중인 경우

ReadAsync 메서드를 사용하면 주 스레드를 차단하지 않고 리소스를 많이 사용하는 I/O 작업을 수행할 수 있습니다. 이 성능 고려 사항은 특히 시간이 많이 드는 스트림 작업이 UI 스레드를 차단하고 앱이 작동하지 않는 것처럼 표시할 수 있는 Windows Windows 스토어 앱이나 바탕 화면 앱에서 중요합니다. 이 비동기 메서드는 Visual Basic 및 C#에서의 asyncawait 키워드와 함께 사용됩니다.

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

Windows Phone OS

지원되는 버전: 8.0

표시:
© 2016 Microsoft