Match Class

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

Represents the results from a single regular expression match.

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

[SerializableAttribute]
public class Match : Group

The Match type exposes the following members.

  NameDescription
Public propertyCapturesGets a collection of all the captures matched by the capturing group, in innermost-leftmost-first order (or innermost-rightmost-first order if the regular expression is modified with the RegexOptions.RightToLeft option). The collection may have zero or more items. (Inherited from Group.)
Public propertyStatic memberEmptyGets the empty group. All failed matches return this empty match.
Public propertyGroupsGets a collection of groups matched by the regular expression.
Public propertyIndexThe position in the original string where the first character of the captured substring is found. (Inherited from Capture.)
Public propertyLengthGets the length of the captured substring. (Inherited from Capture.)
Public propertySuccessGets a value indicating whether the match is successful. (Inherited from Group.)
Public propertyValueGets the captured substring from the input string. (Inherited from Capture.)
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodNextMatchReturns a new Match object with the results for the next match, starting at the position at which the last match ended (at the character after the last matched character).
Public methodResultReturns the expansion of the specified replacement pattern.
Public methodStatic memberSynchronizedReturns a Match instance equivalent to the one supplied that is suitable to share between multiple threads.
Public methodToStringRetrieves the captured substring from the input string by calling the Value property. (Inherited from Capture.)
Top

The Match object is immutable and has no public constructor. An instance of the Match class is returned by the Regex..::..Match method and represents the first pattern match in a string. Subsequent matches are represented by Match objects returned by the Match..::..NextMatch method. In addition, a MatchCollection object that consists of zero, one, or more Match objects is returned by the Regex..::..Matches method.

If the Regex..::..Match method fails to match the regular expression pattern, it returns a Match object that is equal to Match..::..Empty. You can use the Success property to determine whether the match was successful.

If a pattern match is successful, the Value property contains the matched substring, the Index property indicates the zero-based starting position of the matched substring in the input string, and the Length property indicates the length of matched substring in the input string.

Because a single match can involve multiple capturing groups, Match has a Groups property that returns the GroupCollection. The GroupCollection has accessors that return each group. The Match instance itself is equivalent to the first object in the collection, at Match.Groups[0] (Match.Groups(0) in Visual Basic), which represents the entire match.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show: