Collection<T>::ICollection::CopyTo Method (Array^, Int32)

 

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

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

private:
virtual void CopyTo(
	Array^ array,
	int index
) sealed = ICollection::CopyTo

Parameters

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 null.

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.

System_CAPS_noteNote

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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: