Match.Groups Proprietà

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

Valore della proprietà

Gruppi di caratteri corrispondenti al criterio.

Commenti

Un criterio di espressione regolare può includere sottoespressioni, definite racchiudendo una parte del criterio di espressione regolare tra parentesi. Ogni sottoespressione di questo tipo costituisce un gruppo. La Groups proprietà fornisce l'accesso alle informazioni su tali corrispondenze di sottoespressione. Ad esempio, il criterio (\d{3})-(\d{3}-\d{4})di espressione regolare , che corrisponde ai numeri di telefono nordamericani, ha due sottoespressioni. Il primo è costituito dal codice di area, che compone le prime tre cifre del numero di telefono. Questo gruppo viene acquisito dal primo set di parentesi, (\d{3}). Il secondo è costituito dal singolo numero di telefono, che compone le ultime sette cifre del numero di telefono. Questo gruppo viene acquisito dal secondo set di parentesi, (\d{3}-\d{4}).

L'oggetto GroupCollectionGroups restituito dalla proprietà ha sempre almeno un membro. Se il motore delle espressioni regolari non riesce a trovare corrispondenze in una determinata stringa di input, il singolo Group oggetto dell'insieme ha la proprietà Group.Success impostata su false e la relativa Group.Value proprietà è impostata su Empty.

Se l'insieme ha più di un membro, il primo elemento dell'insieme è uguale all'oggetto Match (l'intera corrispondenza). Ogni membro successivo rappresenta un gruppo acquisito, se l'espressione regolare include gruppi di acquisizione. È possibile accedere ai gruppi tramite l'indice integer o, per i gruppi denominati, in base al nome.