Regex.GroupNumberFromName(String) Метод

Определение

Возвращает номер группы, соответствующий указанному имени группы.

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

Номер группы, соответствующий указанному имени группы, или -1, если name является недопустимым именем группы.

Исключения

name имеет значение null.

Комментарии

Шаблон регулярного выражения может содержать именованные или нумерованные группы записи, которые обозначают вложенные выражения в соответствии с шаблоном. Нумерованные группы разделяются синтаксисом (вложенным выражением) и назначаются числа в зависимости от их порядка в регулярном выражении. Именованные группы разделяются синтаксисом (?< Имя> subexpression) или (? name'subexpression), где имя — это имя, по которому будет определена часть выражения. (Дополнительные сведения см. в разделе "Конструкции группирования".) Этот GroupNumberFromName метод определяет как именованные группы, так и нумерованные группы по порядковой позиции в регулярном выражении. Порядковое положение ноль всегда представляет все регулярное выражение. Затем все нумерованные группы учитываются до именованных групп независимо от их фактической позиции в шаблоне регулярного выражения.

Если name строковое представление номера группы, присутствующих в шаблоне регулярного выражения, метод возвращает это число. Если name соответствует именованной группе записи, которая присутствует в шаблоне регулярного выражения, метод возвращает соответствующее число. Сравнение name с именем группы учитывает регистр. Если name не соответствует имени захватываемой группы или строкового представления числа захватываемой группы, метод возвращает значение -1.

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

См. также раздел