Collection<T>::CopyTo Method

Copies the entire Collection<T> to a compatible one-dimensional Array, starting at the specified index of the target array.

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

public:
virtual void CopyTo(
	array<T>^ array, 
	int index
) sealed

Parameters

array
Type: array<T>

The one-dimensional Array that is the destination of the elements copied from Collection<T>. The Array must have zero-based indexing.

index
Type: System::Int32

The zero-based index in array at which copying begins.

Implements

ICollection<T>::CopyTo(array<T>, Int32)

ExceptionCondition
ArgumentNullException

array is nullptr.

ArgumentOutOfRangeException

index is less than zero.

ArgumentException

The number of elements in the source Collection<T> is greater than the available space from index to the end of the destination array.

This method uses Array::Copy to copy the elements.

The elements are copied to the Array in the same order in which the enumerator iterates through the Collection<T>.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft