Regex.GroupNumberFromName(String) 方法

定义

返回与指定组名相对应的组号。

C#
public int GroupNumberFromName(string name);

参数

name
String

要转换为相应组号的组名。

返回

与指定组名相对应的组号,如果 name 不是有效组名,则为 -1。

例外

namenull

注解

正则表达式模式可以包含命名或编号捕获组,这些组描述模式匹配中的子表达式。 编号组由 子表达式) 语法 (分隔,并根据它们在正则表达式中的顺序分配数字。 命名组由语法 (分隔?<名字>subexpression) 还是 (?name'subexpression) ,其中 name 是标识 subexpression 的名称。 (有关详细信息,请参阅 Grouping Constructs.) 方法 GroupNumberFromName 按正则表达式中的序号位置标识命名组和编号组。 序号位置零始终表示整个正则表达式。 然后,所有编号组在命名组之前进行计数,而不管它们在正则表达式模式中的实际位置如何。

如果 name 是正则表达式模式中存在的组数的字符串表示形式,则该方法返回该数字。 如果 name 对应于正则表达式模式中存在的命名捕获组,该方法将返回其相应的数字。 与 name 组名称的比较区分大小写。 如果 name 与捕获组的名称或捕获组编号的字符串表示形式不对应,该方法将返回 -1。

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

另请参阅