Match.Groups 属性

定义

获取由正则表达式匹配的组的集合。

public:
 virtual property System::Text::RegularExpressions::GroupCollection ^ Groups { System::Text::RegularExpressions::GroupCollection ^ get(); };
public virtual System.Text.RegularExpressions.GroupCollection Groups { get; }
member this.Groups : System.Text.RegularExpressions.GroupCollection
Public Overridable ReadOnly Property Groups As GroupCollection

属性值

模式匹配的字符组。

注解

正则表达式模式可以包含子表达式模式,这些子表达式是通过将正则表达式模式的一部分括在括号中定义的。 每个此类子表达式都构成一个组。 该 Groups 属性提供对这些子表达式匹配项的信息的访问权限。 例如,与北美电话号码匹配的正则表达式模式 (\d{3})-(\d{3}-\d{4})有两个子表达式。 第一个代码由区号组成,由电话号码的前三位数字组成。 此组由第一组括号捕获。 (\d{3}) 第二个电话号码由单个电话号码组成,该电话号码由电话号码的最后七位数字组成。 此组由第二组括号捕获。 (\d{3}-\d{4})

属性 GroupCollection 返回 Groups 的对象始终至少有一个成员。 如果正则表达式引擎在特定的输入字符串中找不到任何匹配项,则集合中的单个 Group 对象将具有其 Group.Success 属性设置为 false ,并且其 Group.Value 属性设置为 Empty

如果集合有多个成员,则集合中的第一项与 Match 对象(整个匹配项)相同。 如果正则表达式包含捕获组,则每个后续成员表示捕获的组。 组可以通过整数索引进行访问,也可以按名称对命名组进行访问。

适用于