MatchCollection::CopyTo Method (Array^, Int32)

 

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:
virtual void CopyTo(
	Array^ array,
	int arrayIndex
) sealed

Parameters

array
Type: System::Array^

The array the collection is to be copied into.

arrayIndex
Type: System::Int32

The position in the array where copying is to begin.

Exception Condition
ArgumentException

array is a multi-dimensional array.

IndexOutOfRangeException

arrayIndex is outside the bounds of array.

-or-

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

RegexMatchTimeoutException

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.

System_CAPS_warningWarning

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
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: