Partager via


Regex.GroupNumberFromName(String) Méthode

Définition

Retourne le numéro de groupe qui correspond au nom de groupe spécifié.

public:
 int GroupNumberFromName(System::String ^ name);
public int GroupNumberFromName (string name);
member this.GroupNumberFromName : string -> int
Public Function GroupNumberFromName (name As String) As Integer

Paramètres

name
String

Nom de groupe à convertir en numéro de groupe correspondant.

Retours

Numéro de groupe correspondant au nom de groupe spécifié, ou -1 si name n'est pas un nom de groupe valide.

Exceptions

name a la valeur null.

Remarques

Un modèle d’expression régulière peut contenir des groupes de capture nommés ou numérotés, qui délimitent des sous-expressions dans une correspondance de modèle. Les groupes numérotés sont délimités par la syntaxe (sous-expression) et sont attribués à des nombres en fonction de leur ordre dans l’expression régulière. Les groupes nommés sont délimités par la syntaxe (?<Nom>sous-expression) ou (? name’subexpression), où name est le nom par lequel la sous-expression sera identifiée. (Pour plus d’informations, consultez Constructions de regroupement.) La GroupNumberFromName méthode identifie à la fois les groupes nommés et les groupes numérotés par leur position ordinale dans l’expression régulière. La position ordinale zéro représente toujours l’expression régulière entière. Tous les groupes numérotés sont ensuite comptés avant les groupes nommés, quelle que soit leur position réelle dans le modèle d’expression régulière.

Si name est la représentation sous forme de chaîne d’un numéro de groupe présent dans le modèle d’expression régulière, la méthode retourne ce nombre. Si name correspond à un groupe de capture nommé présent dans le modèle d’expression régulière, la méthode retourne son nombre correspondant. La comparaison de name avec le nom du groupe respecte la casse. Si name ne correspond pas au nom d’un groupe de capture ou à la représentation sous forme de chaîne du numéro d’un groupe de capture, la méthode retourne -1.

S’applique à

Voir aussi