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