Match.Groups Egenskap

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

Egenskapsvärde

De teckengrupper som matchas av mönstret.

Kommentarer

Ett mönster för reguljära uttryck kan innehålla underuttryck som definieras genom att omsluta en del av mönstret för reguljära uttryck inom parenteser. Varje sådan underuttryck bildar en grupp. Egenskapen Groups ger åtkomst till information om dessa underuttrycksmatchningar. Till exempel har det reguljära uttrycksmönstret (\d{3})-(\d{3}-\d{4}), som matchar nordamerikanska telefonnummer, två underuttryck. Den första består av riktnumret, som består av de tre första siffrorna i telefonnumret. Den här gruppen fångas upp av den första uppsättningen parenteser, (\d{3}). Den andra består av det enskilda telefonnumret, som består av de sista sju siffrorna i telefonnumret. Den här gruppen fångas upp av den andra uppsättningen parenteser, (\d{3}-\d{4}).

Objektet GroupCollection som returneras av egenskapen Groups har alltid minst en medlem. Om motorn för reguljära uttryck inte kan hitta några matchningar i en viss indatasträng har det enskilda Group objektet i samlingen sin Group.Success egenskap inställd på false och dess Group.Value egenskap är inställd på Empty.

Om samlingen har fler än en medlem är det första objektet i samlingen detsamma som Match objektet (hela matchningen). Varje efterföljande medlem representerar en samlad grupp, om det reguljära uttrycket innehåller insamlingsgrupper. Grupper kan nås med sitt heltalsindex eller, för namngivna grupper, efter namn.