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

Stream.CopyToAsync 메서드 (Stream, Int32, CancellationToken)

2013-12-13

현재 스트림에서 바이트를 비동기적으로 읽은 다음 지정된 버퍼 크기 및 취소 토큰을 사용하여 다른 스트림에 씁니다.

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

public virtual Task CopyToAsync(
	Stream destination,
	int bufferSize,
	CancellationToken cancellationToken
)

매개 변수

destination
형식: System.IO.Stream
현재 스트림의 내용을 복사할 스트림입니다.
bufferSize
형식: System.Int32
버퍼의 크기(바이트)입니다. 이 값은 0보다 커야 합니다. 기본 크기는 4096입니다.
cancellationToken
형식: System.Threading.CancellationToken
취소 요청을 모니터링할 토큰입니다. 기본값은 None입니다.

반환 값

형식: System.Threading.Tasks.Task
비동기 복사 작업을 나타내는 작업입니다.

예외조건
ArgumentNullException

destinationnull인 경우

ArgumentOutOfRangeException

buffersize가 음수나 0인 경우

ObjectDisposedException

현재 스트림이나 대상 스트림이 삭제된 경우

NotSupportedException

현재 스트림이 읽기를 지원하지 않는 경우 또는 대상 스트림이 쓰기를 지원하지 않는 경우

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

작업이 완료되기 전에 취소되는 경우 반환된 작업에는 Status 속성에 대한 Canceled 값이 들어 있습니다.

현재 스트림의 현재 위치에서 복사가 시작됩니다.

두 스트림 간의 복사에 대한 예제를 보려면 CopyToAsync 오버로드를 참조하세요.

Windows Phone OS

지원되는 버전: 8.0

표시: