Regex.GroupNumberFromName(String) Método

Definición

Devuelve el número de grupo que corresponde al nombre de grupo especificado.Returns the group number that corresponds to the specified group name.

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.The group name to convert to the corresponding group number.

Devoluciones

Número del grupo que corresponde al nombre de grupo especificado o -1 si name no es un nombre de grupo válido.The group number that corresponds to the specified group name, or -1 if name is not a valid group name.

Excepciones

name es null.name is 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 patrones.A regular expression pattern may contain either named or numbered capturing groups, which delineate subexpressions within a pattern match. Los grupos numerados se delimitan mediante la sintaxis (subexpresión) y se asignan números según su orden en la expresión regular.Numbered groups are delimited by the syntax (subexpression) and are assigned numbers based on their order in the regular expression. Los grupos con nombre se delimitan mediante la sintaxis (?<nombre>subexpresión) o (? ' nombre'subexpresión, donde nombre es el nombre por el que se identificará la subexpresión.Named groups are delimited by the syntax (?<name>subexpression) or (?'name'subexpression), where name is the name by which the subexpression will be identified. (Para obtener más información, consulte construcciones de agrupamiento). El método GroupNumberFromName identifica los grupos con nombre y los grupos numerados por sus posiciones ordinales en la expresión regular.(For more information, see Grouping Constructs.) The GroupNumberFromName method identifies both named groups and numbered groups by their ordinal positions in the regular expression. La posición ordinal cero siempre representa la expresión regular completa.Ordinal position zero always represents the entire regular expression. A continuación, se cuentan todos los grupos numerados antes de los grupos con nombre, independientemente de su posición real en el patrón de expresión regular.All numbered groups are then counted before named groups, regardless of their actual position in the regular expression pattern.

Si name es la representación de cadena de un número de grupo que se encuentra en el patrón de expresión regular, el método devuelve ese número.If name is the string representation of a group number that is present in the regular expression pattern, the method returns that number. Si name corresponde a un grupo de captura con nombre que se encuentra en el patrón de expresión regular, el método devuelve su número correspondiente.If name corresponds to a named capturing group that is present in the regular expression pattern, the method returns its corresponding number. La comparación de name con el nombre de grupo distingue entre mayúsculas y minúsculas.The comparison of name with the group name is case-sensitive. Si name no se corresponde con el nombre de un grupo de captura o con la representación de cadena del número de un grupo de captura, el método devuelve-1.If name does not correspond to the name of a capturing group or to the string representation of the number of a capturing group, the method returns -1.

Se aplica a

Consulte también: