Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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:
© 2017 Microsoft