Match.Groups 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取由正则表达式匹配的组的集合。
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 对象(整个匹配项)相同。 如果正则表达式包含捕获组,则每个后续成员表示捕获的组。 组可以通过整数索引进行访问,也可以按名称对命名组进行访问。