• Article

Stream.CopyTo Method (Stream, Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Reads all the bytes from the current stream and writes them to a destination stream, using a specified buffer size.

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

Syntax

'Declaration
Public Sub CopyTo ( _
    destination As Stream, _
    bufferSize As Integer _
)

public void CopyTo(
    Stream destination,
    int bufferSize
)

Parameters

  • destination
    Type: System.IO.Stream
    The stream that will contain the contents of the current stream.
  • bufferSize
    Type: System.Int32
    The size of the buffer. This value must be greater than zero. The default size is 4096.

Exceptions

Exception Condition
ArgumentNullException

destination is nulla null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException

bufferSize is negative or zero.
NotSupportedException

The current stream does not support reading.

-or-

destination does not support writing.
ObjectDisposedException

Either the current stream or destination were closed before the CopyTo method was called.
IOException

An I/O error occurred.

Remarks

Copying begins at the current position in the current stream.

Version Information

Silverlight

Supported in: 5, 4

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.