Regex.GroupNumberFromName(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> intPublic Function GroupNumberFromName (name As String) As IntegerParamè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.
