ICollection.CopyTo Method

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

 

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)

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.

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.

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

System_CAPS_noteNote

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 4.5
.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:
© 2016 Microsoft