Dictionary<TKey, TValue>::ICollection::CopyTo Method (Array^, Int32)

.NET Framework (current version)

Copies the elements of the ICollection<T> to an array, starting at the specified array index.

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

Syntax

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<T>. The array must have zero-based indexing.

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

Implements

ICollection::CopyTo(Array^, Int32)

Exceptions

Exception	Condition
ArgumentNullException	array is null.
ArgumentOutOfRangeException	index is less than 0.
ArgumentException	array is multidimensional. -or- array does not have zero-based indexing. -or- The number of elements in the source ICollection<T> is greater than the available space from index to the end of the destination array. -or- The type of the source ICollection<T> cannot be cast automatically to the type of the destination array.

Remarks

Each element copied from a Dictionary<TKey, TValue> is a KeyValuePair<TKey, TValue> structure representing a value and its key.

Note
If the type of the source ICollection cannot be cast automatically to the type of the destination array, the nongeneric implementations of ICollection::CopyTo throw an InvalidCastException, whereas the generic implementations throw an 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