Match.Groups Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling groepen op die overeenkomen met de reguliere expressie.
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.GroupCollectionPublic Overridable ReadOnly Property Groups As GroupCollectionWaarde van eigenschap
De tekengroepen komen overeen met het patroon.
Opmerkingen
Een patroon voor reguliere expressies kan subexpressies bevatten, die worden gedefinieerd door een deel van het reguliere expressiepatroon tussen haakjes te sluiten. Elke subexpressie vormt een groep. De Groups eigenschap biedt toegang tot informatie over deze subexpressieovereenkomsten. Het reguliere expressiepatroon (\d{3})-(\d{3}-\d{4}), dat overeenkomt met Noord-Amerikaanse telefoonnummers, heeft bijvoorbeeld twee subexpressies. De eerste bestaat uit het netnummer, dat de eerste drie cijfers van het telefoonnummer bevat. Deze groep wordt vastgelegd door de eerste set haakjes, (\d{3}). De tweede bestaat uit het afzonderlijke telefoonnummer, dat de laatste zeven cijfers van het telefoonnummer bevat. Deze groep wordt vastgelegd door de tweede set haakjes, (\d{3}-\d{4}).
Het GroupCollection object dat door de Groups eigenschap wordt geretourneerd, heeft altijd ten minste één lid. Als de engine voor reguliere expressies geen overeenkomsten in een bepaalde invoertekenreeks kan vinden, heeft het ene Group object in de verzameling de Group.Success eigenschap ingesteld false op en de Group.Value eigenschap ingesteld op Empty.
Als de verzameling meer dan één lid heeft, is het eerste item in de verzameling hetzelfde als het Match object (de hele overeenkomst). Elk volgend lid vertegenwoordigt een vastgelegde groep als de reguliere expressie het vastleggen van groepen omvat. Groepen kunnen worden geopend op basis van hun gehele getalindex of, voor benoemde groepen, op naam.
