Match.Groups Właściwość

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

Wartość właściwości

Grupy znaków dopasowane przez wzorzec.

Uwagi

Wzorzec wyrażenia regularnego może zawierać podrażenia, które są definiowane przez dołączenie części wzorca wyrażenia regularnego w nawiasy. Każde takie podrażenie tworzy grupę. Właściwość Groups zapewnia dostęp do informacji o tych dopasowaniach podexpressionu. Na przykład wzorzec (\d{3})-(\d{3}-\d{4})wyrażenia regularnego, który pasuje do numerów telefonów w Ameryce Północnej, ma dwa podexpressiony. Pierwszy składa się z kodu obszaru, który składa się z pierwszych trzech cyfr numeru telefonu. Ta grupa jest przechwytywana przez pierwszy zestaw nawiasów: (\d{3}). Drugi składa się z indywidualnego numeru telefonu, który składa się z ostatnich siedmiu cyfr numeru telefonu. Ta grupa jest przechwytywana przez drugi zestaw nawiasów: (\d{3}-\d{4}).

GroupCollection Obiekt zwracany przez Groups właściwość zawsze ma co najmniej jeden element członkowski. Jeśli aparat wyrażeń regularnych nie może odnaleźć żadnych dopasowań w określonym ciągu wejściowym, pojedynczy Group obiekt w kolekcji ma jej Group.Success właściwość ustawioną na false wartość i jej Group.Value właściwość ustawioną na Emptywartość .

Jeśli kolekcja ma więcej niż jeden element członkowski, pierwszy element w kolekcji jest taki sam jak Match obiekt (całe dopasowanie). Każdy kolejny element członkowski reprezentuje przechwyconą grupę, jeśli wyrażenie regularne zawiera przechwytywanie grup. Dostęp do grup można uzyskać za pomocą indeksu liczby całkowitej lub, dla nazwanych grup, według nazwy.