NameValueCollection.CopyTo Method

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

Namespace: System.Collections.Specialized
Assembly: System (in system.dll)

void CopyTo (
	Array^ dest, 
	int index
public void CopyTo (
	Array dest, 
	int index
public function CopyTo (
	dest : Array, 
	index : int
Not applicable.



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


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

Exception typeCondition


dest is a null reference (Nothing in Visual Basic).


index is less than zero.


dest is multidimensional.


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


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


The type of the source NameValueCollection cannot be cast automatically to the type of the destination dest.

The specified array must be of a compatible type.

This method uses Array.Copy to copy the elements.

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0