Match.Groups Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma coleção de grupos correspondidos pela expressão regular.
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 GroupCollectionValor de Propriedade
Os grupos de personagens correspondiam ao padrão.
Observações
Um padrão de expressão regular pode incluir subexpressões, que são definidas por incluir uma parte do padrão de expressão regular entre parênteses. Cada subexpressão desse tipo forma um grupo. A Groups propriedade proporciona acesso a informações sobre essas correspondências de subexpressões. Por exemplo, o padrão (\d{3})-(\d{3}-\d{4})de expressões regulares , que corresponde a números de telefone norte-americanos, tem duas subexpressões. O primeiro consiste no indicativo de área, que compõe os três primeiros dígitos do número de telefone. Este grupo é capturado pelo primeiro conjunto de parênteses, (\d{3}). O segundo consiste no número de telefone individual, que compõe os últimos sete dígitos do número de telefone. Este grupo é capturado pelo segundo conjunto de parênteses, (\d{3}-\d{4}).
O GroupCollection objeto devolvido pela Groups propriedade tem sempre pelo menos um membro. Se o motor de expressões regulares não conseguir encontrar correspondências numa determinada cadeia de entrada, o único Group objeto na coleção tem Group.Success a sua propriedade definida como false e a sua Group.Value propriedade definida como Empty.
Se a coleção tiver mais do que um membro, o primeiro item da coleção é o mesmo que o Match objeto (a combinação completa). Cada membro subsequente representa um grupo capturado, se a expressão regular incluir grupos capturadores. Os grupos podem ser acedidos pelo seu índice inteiro ou, para grupos nomeados, pelo nome.
