Regex.GroupNumberFromName(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает номер группы, соответствующий указанному имени группы.
public:
int GroupNumberFromName(System::String ^ name);public int GroupNumberFromName (string name);member this.GroupNumberFromName : string -> intPublic Function GroupNumberFromName (name As String) As IntegerПараметры
- name
- String
Имя группы для преобразования в соответствующий номер группы.
Возвращаемое значение
Номер группы, соответствующий указанному имени группы, или -1, если name является недопустимым именем группы.
Исключения
name имеет значение null.
Комментарии
Шаблон регулярного выражения может содержать именованные или нумерованные группы записи, которые обозначают вложенные выражения в соответствии с шаблоном. Нумерованные группы разделяются синтаксисом (вложенным выражением) и назначаются числа в зависимости от их порядка в регулярном выражении. Именованные группы разделяются синтаксисом (?< Имя> subexpression) или (? name'subexpression), где имя — это имя, по которому будет определена часть выражения. (Дополнительные сведения см. в разделе "Конструкции группирования".) Этот GroupNumberFromName метод определяет как именованные группы, так и нумерованные группы по порядковой позиции в регулярном выражении. Порядковое положение ноль всегда представляет все регулярное выражение. Затем все нумерованные группы учитываются до именованных групп независимо от их фактической позиции в шаблоне регулярного выражения.
Если name строковое представление номера группы, присутствующих в шаблоне регулярного выражения, метод возвращает это число. Если name соответствует именованной группе записи, которая присутствует в шаблоне регулярного выражения, метод возвращает соответствующее число. Сравнение name с именем группы учитывает регистр. Если name не соответствует имени захватываемой группы или строкового представления числа захватываемой группы, метод возвращает значение -1.