Share via

Count Property

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Gets the number of matches.

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

Syntax

'Declaration
Public ReadOnly Property Count As Integer

public int Count { get; }

public:
virtual property int Count {
    int get () sealed;
}

abstract Count : int with get
override Count : int with get

final function get Count () : int

Property Value

Type: System. . :: . .Int32
The number of matches.

Implements

ICollection. . :: . .Count

Remarks

Accessing individual members of the MatchCollection object by retrieving the value of the collection's Count property causes the regular expression engine to populate the collection using direct evaluation. ln contrast, calling the GetEnumerator method (or using the foreach statement in C# and the For Each...Next statement in Visual Basic) causes the regular expression engine to populate the collection on an as needed basis using lazy evaluation. Direct evaluation can be a much more expensive method of building the collection than lazy evaluation.

Because the MatchCollection object is generally populated by using lazy evaluation, trying to determine the number of elements in 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 Security

See Also

Reference

MatchCollection Class

System.Text.RegularExpressions Namespace