MatchCollection.CopyTo Method (Array, Int32)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Copies all the elements of the collection to the given array starting at the given index.

Namespace:   System.Text.RegularExpressions
Assembly:  System (in System.dll)

public void CopyTo(
	Array array,
	int arrayIndex


Type: System.Array

The array the collection is to be copied into.

Type: System.Int32

The position in the array where copying is to begin.

Exception Condition

array is a multi-dimensional array.


arrayIndex is outside the bounds of array.


arrayIndex plus MatchCollection.Count is outside the bounds of array.


A time-out occurred.

Because the collection is copied into the array starting at the given index, the destination array must be at least as large as the entire collection.


This member is not present in the Portable Class Library. If you are developing applications that target the Portable Class Library, use the CaptureCollection.ICollection.CopyTo method instead.

Because the MatchCollection object is generally populated by using lazy evaluation, trying to copy the collection before it has been fully populated may throw a RegexMatchTimeoutException exception. This exception can be thrown if a time-out value for matching operations is in effect, and the attempt to find a single match exceeds that time-out interval.

.NET Framework
Available since 1.1
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top