Array.CopyTo Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub CopyTo ( _
array As Array, _
index As Integer _
)
public void CopyTo(
Array array,
int index
)
Parameters
- array
Type: System.Array
The one-dimensional Array that is the destination of the elements copied from the current Array.
- index
Type: System.Int32
A 32-bit integer that represents the index in array at which copying begins.
Implements
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | array is nulla null reference (Nothing in Visual Basic). |
| ArgumentOutOfRangeException | index is less than the lower bound of array. |
| ArgumentException | array is multidimensional. -or- The number of elements in the source Array is greater than the available space from index to the end of the destination array. |
| ArrayTypeMismatchException | The type of the source Array cannot be cast automatically to the type of the destination array. |
| RankException | The source Array is multidimensional. |
| InvalidCastException | At least one element in the source Array cannot be cast to the type of destination array. |
Remarks
This method supports the System.Collections.ICollection interface. If implementing System.Collections.ICollection is not explicitly required, use Copy to avoid an extra indirection.
If this method throws an exception while copying, the state of array is undefined.
This method is an O(n) operation, where n is Length.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.