MatchCollection.CopyTo Method

Definition

Namespace:

System.Text.RegularExpressions

Assembly:

System.Text.RegularExpressions.dll

Overloads

CopyTo(Array, Int32)	Copies all the elements of the collection to the given array starting at the given index.
CopyTo(Match[], Int32)	Copies the elements of the collection to an Array, starting at a particular Array index.

CopyTo(Array, Int32)

Source:

MatchCollection.cs

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

public:
 virtual void CopyTo(Array ^ array, int arrayIndex);

public void CopyTo (Array array, int arrayIndex);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Sub CopyTo (array As Array, arrayIndex As Integer)

Parameters

array

Array

The array the collection is to be copied into.

arrayIndex

Int32

The position in the array where copying is to begin.

Implements

CopyTo(Array, Int32)

Exceptions

ArgumentException

array is a multi-dimensional array.

IndexOutOfRangeException

arrayIndex is outside the bounds of array.

-or-

arrayIndex plus Count is outside the bounds of array.

RegexMatchTimeoutException

A time-out occurred.

Remarks

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.

Warning

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.

CopyTo(Match[], Int32)

Source:

MatchCollection.cs

Copies the elements of the collection to an Array, starting at a particular Array index.

public:
 virtual void CopyTo(cli::array <System::Text::RegularExpressions::Match ^> ^ array, int arrayIndex);

public void CopyTo (System.Text.RegularExpressions.Match[] array, int arrayIndex);

abstract member CopyTo : System.Text.RegularExpressions.Match[] * int -> unit
override this.CopyTo : System.Text.RegularExpressions.Match[] * int -> unit

Public Sub CopyTo (array As Match(), arrayIndex As Integer)

Parameters

array

Match[]

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

arrayIndex

Int32

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

Implements

CopyTo(T[], Int32)