This topic has not yet been rated - Rate this topic

Collection<T>.CopyTo Method

.NET Framework 4.5

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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)

Syntax

C++

Copy

public void CopyTo(
	T[] array,
	int index
)

Parameters

array: Type: 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(T[], Int32)

Exceptions

Exception	Condition
ArgumentNullException	array is null.
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.

Remarks

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.

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

Platforms

Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, 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.

Reference

Collection<T> Class

System.Collections.ObjectModel Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)