.NET Framework Class Library
CollectionTCopyTo Method

Copies the entire CollectionT to a compatible one-dimensional Array, starting at the specified index of the target array.

Namespace:   System.Collections.ObjectModel
Assembly:  mscorlib (in mscorlib.dll)
Syntax
Public Sub CopyTo ( _
	array As T(), _
	index As [%$TOPIC/ms132408_en-us_VS_110_3_0_0_0_0%] _
)
public void CopyTo(
	T[] array,
	[%$TOPIC/ms132408_en-us_VS_110_3_0_1_0_0%] index
)
public:
virtual void CopyTo(
	array<T>^ array, 
	[%$TOPIC/ms132408_en-us_VS_110_3_0_2_0_0%] index
) sealed
abstract CopyTo : 
        array:'T[] * 
        index:[%$TOPIC/ms132408_en-us_VS_110_3_0_3_0_0%] -> unit  
override CopyTo : 
        array:'T[] * 
        index:[%$TOPIC/ms132408_en-us_VS_110_3_0_3_0_1%] -> unit

Parameters

array
Type: T

The one-dimensional Array that is the destination of the elements copied from CollectionT. The Array must have zero-based indexing.

index
Type: SystemInt32

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

Implements

ICollectionTCopyTo(T, Int32)
Exceptions
ExceptionCondition
ArgumentNullException

array is .

ArgumentOutOfRangeException

index is less than zero.

ArgumentException

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

Remarks

This method uses ArrayCopy to copy the elements.

The elements are copied to the Array in the same order in which the enumerator iterates through the CollectionT.

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

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8
Platforms

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.