Regex.GroupNumberFromName(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve el número de grupo que corresponde al nombre de grupo especificado.
public:
int GroupNumberFromName(System::String ^ name);public int GroupNumberFromName (string name);member this.GroupNumberFromName : string -> intPublic Function GroupNumberFromName (name As String) As IntegerParámetros
- name
- String
Nombre de grupo para convertir al número de grupo correspondiente.
Devoluciones
Número del grupo que corresponde al nombre de grupo especificado o -1 si name no es un nombre de grupo válido.
Excepciones
name es null.
Comentarios
Un patrón de expresión regular puede contener grupos de captura con nombre o numerados, que delimitan subexpresiones dentro de una coincidencia de patrón. Los grupos numerados se delimitan por la sintaxis (subexpresión) y se asignan números en función de su orden en la expresión regular. Los grupos con nombre están delimitados por la sintaxis (?< Nombre> subexpresión) o (?' name'subexpression), donde name es el nombre por el que se identificará la subexpresión. (Para obtener más información, vea Construcciones de agrupación). El GroupNumberFromName método identifica los grupos con nombre y los grupos numerados por sus posiciones ordinales en la expresión regular. La posición ordinal cero siempre representa toda la expresión regular. Todos los grupos numerados se cuentan antes de los grupos con nombre, independientemente de su posición real en el patrón de expresión regular.
Si name es la representación de cadena de un número de grupo que está presente en el patrón de expresión regular, el método devuelve ese número. Si name corresponde a un grupo de captura con nombre que está presente en el patrón de expresión regular, el método devuelve su número correspondiente. La comparación de con el nombre del grupo distingue mayúsculas de name minúsculas. Si name no corresponde al nombre de un grupo de captura o a la representación de cadena del número de un grupo de captura, el método devuelve -1.