Match.Groups Propriété

public:
 virtual property System::Text::RegularExpressions::GroupCollection ^ Groups { System::Text::RegularExpressions::GroupCollection ^ get(); };

public virtual System.Text.RegularExpressions.GroupCollection Groups { get; }

member this.Groups : System.Text.RegularExpressions.GroupCollection

Public Overridable ReadOnly Property Groups As GroupCollection

Valeur de propriété

Groupes de caractères mis en correspondance par le modèle.

Remarques

Un modèle d’expression régulière peut inclure des sous-expressions, qui sont définies en englobant une partie du modèle d’expression régulière entre parenthèses. Chaque sous-expression de ce type forme un groupe. La Groups propriété fournit l’accès aux informations relatives à ces correspondances de sous-expression. Par exemple, le modèle (\d{3})-(\d{3}-\d{4})d’expression régulière, qui correspond aux numéros de téléphone nord-américains, a deux sous-expressions. Le premier se compose du code de zone, qui compose les trois premiers chiffres du numéro de téléphone. Ce groupe est capturé par le premier ensemble de parenthèses. (\d{3}) Le deuxième est constitué du numéro de téléphone individuel, qui compose les sept derniers chiffres du numéro de téléphone. Ce groupe est capturé par le deuxième jeu de parenthèses. (\d{3}-\d{4})

L’objet GroupCollection retourné par la Groups propriété a toujours au moins un membre. Si le moteur d’expression régulière ne trouve aucune correspondance dans une chaîne d’entrée particulière, l’objet unique Group de la collection a sa Group.Success propriété définie false sur et sa Group.Value propriété définie sur Empty.

Si la collection a plusieurs membres, le premier élément de la collection est le même que l’objet Match (correspondance entière). Chaque membre suivant représente un groupe capturé, si l’expression régulière inclut des groupes de capture. Les groupes sont accessibles par leur index entier ou, pour les groupes nommés, par nom.