Collection<(Of <(T>)>).ICollection.CopyTo Method

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

Copies the elements of the ICollection to an Array, starting at a particular Array index.

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

Syntax

Private Sub CopyTo ( _
    array As Array, _
    index As Integer _
) Implements ICollection.CopyTo

void ICollection.CopyTo(
    Array array,
    int index
)

array
Type: System..::.Array
The one-dimensional Array that is the destination of the elements copied from ICollection. The Array must have zero-based indexing.

index
Type: System..::.Int32
The zero-based index in array at which copying begins.

Exception	Condition
ArgumentNullException	array is nullNothingnullptra null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	index is less than zero.
ArgumentException	array is multidimensional. -or- array does not have zero-based indexing. -or- The number of elements in the source ICollection is greater than the available space from index to the end of the destination array. -or- The type of the source ICollection cannot be cast automatically to the type of the destination array.

array is nullNothingnullptra null reference (Nothing in Visual Basic).

index is less than zero.

array is multidimensional.

-or-

array does not have zero-based indexing.

-or-

The number of elements in the source ICollection is greater than the available space from index to the end of the destination array.

-or-

The type of the source ICollection cannot be cast automatically to the type of the destination array.

Note

If the type of the source ICollection cannot be cast automatically to the type of the destination array, the non-generic implementations of ICollection..::.CopyTo throw InvalidCastException, whereas the generic implementations throw ArgumentException.

This method is an O(n) operation, where n is Count.

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone