This documentation is archived and is not being maintained.

DictionaryBase.CopyTo Method

Copies the DictionaryBase elements to a one-dimensional Array at the specified index.

[Visual Basic]
Public Overridable Sub CopyTo( _
   ByVal array As Array, _
   ByVal index As Integer _
) Implements ICollection.CopyTo
[C#]
public virtual void CopyTo(
 Array array,
 int index
);
[C++]
public: virtual void CopyTo(
 Array* array,
 int index
);
[JScript]
public function CopyTo(
   array : Array,
 index : int
);

Parameters

array
The one-dimensional Array that is the destination of the DictionaryEntry objects copied from the DictionaryBase instance. The Array must have zero-based indexing.
index
The zero-based index in array at which copying begins.

Implements

ICollection.CopyTo

Exceptions

Exception Type Condition
ArgumentNullException array is a null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException index is less than zero.
ArgumentException array is multidimensional.

-or-

index is equal to or greater than the length of array.

-or-

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

InvalidCastException The type of the source DictionaryBase cannot be cast automatically to the type of the destination array.

Remarks

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

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

DictionaryBase Class | DictionaryBase Members | System.Collections Namespace | System.Array | DictionaryEntry | GetEnumerator

Show: