Array.CopyTo Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index. The index is specified as a 32-bit integer.

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

Syntax

Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
public void CopyTo(
    Array array,
    int index
)

Parameters

  • index
    Type: System..::.Int32
    A 32-bit integer that represents the index in array at which copying begins.

Implements

ICollection..::.CopyTo(Array, Int32)

Exceptions

Exception Condition
ArgumentNullException

array is nullNothingnullptra 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

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

Array Class

System Namespace

ICollection

Copy