Regex.GroupNumberFromName(String) Метод

Определение

Возвращает номер группы, соответствующий указанному имени группы.Returns the group number that corresponds to the specified group name.

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

Имя группы для преобразования в соответствующий номер группы.The group name to convert to the corresponding group number.

Возвраты

Номер группы, соответствующий указанному имени группы, или -1, если name является недопустимым именем группы.The group number that corresponds to the specified group name, or -1 if name is not a valid group name.

Исключения

Свойство name имеет значение null.name is null.

Комментарии

Шаблон регулярного выражения может содержать именованные или нумерованные группы записи, которые выделяют части выражения в соответствии с шаблоном.A regular expression pattern may contain either named or numbered capturing groups, which delineate subexpressions within a pattern match. Нумерованные группы разделяются синтаксисом (часть выражения) и присваиваются числа на основе их порядка в регулярном выражении.Numbered groups are delimited by the syntax (subexpression) and are assigned numbers based on their order in the regular expression. Именованные группы разделяются синтаксисом (?< имя часть выражения) или (?) ** > Name"часть выражения", где Name — имя, по которому будет идентифицирована часть выражения.Named groups are delimited by the syntax (?<name>subexpression) or (?'name'subexpression), where name is the name by which the subexpression will be identified. (Дополнительные сведения см. в разделе Конструкции группировки.) GroupNumberFromName Метод определяет как именованные группы, так и нумерованные группы по их порядковым позициям в регулярном выражении.(For more information, see Grouping Constructs.) The GroupNumberFromName method identifies both named groups and numbered groups by their ordinal positions in the regular expression. Нулевое значение порядкового номера всегда представляет собой полное регулярное выражение.Ordinal position zero always represents the entire regular expression. Затем все пронумерованные группы подсчитываются до именованных групп, независимо от их фактического расположения в шаблоне регулярного выражения.All numbered groups are then counted before named groups, regardless of their actual position in the regular expression pattern.

Если name является строковым представлением номера группы, присутствующего в шаблоне регулярного выражения, метод возвращает это число.If name is the string representation of a group number that is present in the regular expression pattern, the method returns that number. Если name соответствует именованной группе записи, представленной в шаблоне регулярного выражения, метод возвращает соответствующее ему число.If name corresponds to a named capturing group that is present in the regular expression pattern, the method returns its corresponding number. name При сравнении с именем группы учитывается регистр.The comparison of name with the group name is case-sensitive. Если name не соответствует имени захваченной группы или строковому представлению номера группы записи, метод возвращает значение-1.If name does not correspond to the name of a capturing group or to the string representation of the number of a capturing group, the method returns -1.

Применяется к

Дополнительно