Compartir a través de


Regex.GroupNumberFromName(String) Método

Definición

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 -> int
Public Function GroupNumberFromName (name As String) As Integer

Parámetros

name
String

Nombre de grupo para convertir al número de grupo correspondiente.

Devoluciones

Int32

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.

Se aplica a

Consulte también