Match 类

定义

命名空间:

System.Text.RegularExpressions

程序集:

netstandard.dll, System.Text.RegularExpressions.dll

Source:

Match.cs

表示单个正则表达式匹配的结果。

public ref class Match : System::Text::RegularExpressions::Group

public class Match : System.Text.RegularExpressions.Group

type Match = class
    inherit Group

Public Class Match
Inherits Group

继承

Object

Capture

Group

Match

注解

该 Match 类是不可变的，没有公共构造函数。 类的 Match 实例由 Match(String) 该方法返回，并表示字符串中的第一个模式匹配。 后续匹配由 Match 方法返回 NextMatch() 的对象表示。 此外， MatchCollection 由零个、一个或多个 Match 对象组成的对象由 Matches(String) 该方法返回。

Matches(String)如果方法无法匹配输入字符串中的正则表达式模式，则返回一个空MatchCollection对象。 然后 foreach ，可以使用构造循环访问集合。

Match(String)如果方法无法匹配正则表达式模式，则返回一个Match等于Empty的对象。 可以使用该 Success 属性来确定匹配是否成功。

如果模式匹配成功， Value 则属性包含匹配的子字符串， Index 该属性指示输入字符串中匹配子字符串的从零开始位置，并且 Length 该属性指示输入字符串中匹配子字符串的长度。

由于单个匹配可能涉及多个捕获组， Match 因此具有返回 Groups 该 GroupCollection属性的属性。 实例 Match 本身等效于集合中的第一个对象，该 Match.Groups[0]对象表示整个匹配项。

属性

名称	说明
Captures	获取捕获组匹配的所有捕获的集合（如果正则表达式使用 RightToLeft 选项修改），则为最内侧-最左边的第一顺序（或最右第一顺序）。 集合可能有零个或多个项。 (继承自 Group)
Empty	获取空匹配项。 所有失败的匹配项都返回此空匹配项。
Groups	获取由正则表达式匹配的组的集合。
Index	获取原始字符串中找到捕获子字符串的第一个字符的位置。 (继承自 Capture)
Length	获取捕获的子字符串的长度。 (继承自 Capture)
Name	返回由当前实例表示的捕获组的名称。 (继承自 Group)
Success	获取一个值，该值指示匹配是否成功。 (继承自 Group)
Value	从输入字符串获取捕获的子字符串。 (继承自 Capture)
ValueSpan	从输入字符串获取捕获的跨度。 (继承自 Capture)

方法

名称	说明
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
NextMatch()	返回一个新 Match 对象，其中包含下一个匹配项的结果，从最后一个匹配字符结束的位置（在最后一个匹配字符之后的字符处开始）。
Result(String)	返回传递的替换模式的扩展。 例如，如果替换模式为 $1$2， Result(String) 则返回连接 Groups[1].Value 和 Groups[2].Value。
Synchronized(Match)	返回一个 Match 等效于提供的实例，该实例可以安全地在多个线程之间共享。
ToString()	通过调用 Value 属性从输入字符串中检索捕获的子字符串。 (继承自 Capture)

另请参阅

• MatchCollection
• Regex