Match.Groups Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Auflistung von Gruppen ab, die mit dem regulären Ausdruck übereinstimmen.
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 GroupCollectionEigenschaftswert
Die Zeichengruppen, die mit dem Muster übereinstimmen.
Hinweise
Ein Muster für reguläre Ausdrücke kann Unterausdrücke enthalten, die durch Einschließen eines Teils des Musters regulärer Ausdrücke in Klammern definiert werden. Jeder solche Unterausdruck bildet eine Gruppe. Die Groups Eigenschaft bietet Zugriff auf Informationen zu diesen Subexpression-Übereinstimmungen. Das Muster (\d{3})-(\d{3}-\d{4})für reguläre Ausdrücke, das mit nordamerikanischen Telefonnummern übereinstimmt, weist beispielsweise zwei Unterausdrücke auf. Der erste besteht aus der Vorwahl, die die ersten drei Ziffern der Telefonnummer erstellt. Diese Gruppe wird von den ersten Klammern erfasst. (\d{3}) Der zweite besteht aus der einzelnen Telefonnummer, die die letzten sieben Ziffern der Telefonnummer verfasst. Diese Gruppe wird von der zweiten Gruppe von Klammern erfasst. (\d{3}-\d{4})
Das GroupCollection von der Groups Eigenschaft zurückgegebene Objekt verfügt immer über mindestens ein Element. Wenn das Modul für reguläre Ausdrücke keine Übereinstimmungen in einer bestimmten Eingabezeichenfolge finden kann, weist das einzelne Group Objekt in der Auflistung seine Group.Success Eigenschaft auf false und seine Group.Value Eigenschaft auf Empty.
Wenn die Auflistung mehr als ein Element aufweist, ist das erste Element in der Auflistung mit dem Match Objekt identisch (die gesamte Übereinstimmung). Jedes nachfolgende Mitglied stellt eine erfasste Gruppe dar, wenn der reguläre Ausdruck Aufnahmegruppen enthält. Auf Gruppen kann über ihren ganzzahligen Index oder nach Namen für benannte Gruppen zugegriffen werden.
