Regex.GroupNumberFromName(String) 方法

定义

命名空间:

System.Text.RegularExpressions

程序集:

System.Text.RegularExpressions.dll

Source:

Regex.cs

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

public:
 int GroupNumberFromName(System::String ^ name);

public int GroupNumberFromName (string name);

member this.GroupNumberFromName : string -> int

Public Function GroupNumberFromName (name As String) As Integer

参数

name

String

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

返回

Int32

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

例外

ArgumentNullException

name 为 null。

注解

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

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

另请参阅

• GroupCollection
• GetGroupNames()
• 正则表达式中的分组构造