Export (0) Print
Expand All

MemoryStream::CopyToAsync Method (Stream, Int32, CancellationToken)

.NET Framework 4.5

Asynchronously reads all the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

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

Parameters

destination
Type: System.IO::Stream

The stream to which the contents of the current stream will be copied.

bufferSize
Type: System::Int32

The size, in bytes, of the buffer. This value must be greater than zero.

cancellationToken
Type: System.Threading::CancellationToken

The token to monitor for cancellation requests.

Return Value

Type: System.Threading.Tasks::Task
A task that represents the asynchronous copy operation.

ExceptionCondition
ArgumentNullException

destination is nullptr.

ArgumentOutOfRangeException

buffersize is negative or zero.

ObjectDisposedException

Either the current stream or the destination stream is disposed.

NotSupportedException

The current stream does not support reading, or the destination stream does not support writing.

.NET Framework

Supported in: 4.5

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft