Group Classe

Definição

public ref class Group : System::Text::RegularExpressions::Capture

public class Group : System.Text.RegularExpressions.Capture

[System.Serializable]
public class Group : System.Text.RegularExpressions.Capture

type Group = class
    inherit Capture

[<System.Serializable>]
type Group = class
    inherit Capture

Public Class Group
Inherits Capture

Herança

Object

Capture

Group

Derivado

System.Text.RegularExpressions.Match

Atributos

SerializableAttribute

Comentários

Um grupo de captura pode capturar zero, uma ou mais cadeias de caracteres em uma única correspondência devido a quantificadores. (Para obter mais informações, consulte Quantifiers.) Todas as subcadeias de caracteres correspondentes a um único grupo de captura estão disponíveis na Group.Captures propriedade. As informações sobre a última subcadeia de caracteres capturada podem ser acessadas diretamente das propriedades e Index das Value propriedades. (Ou seja, a Group instância é equivalente ao último item da coleção retornado pela propriedade, que Captures reflete a última captura feita pelo grupo de captura.)

Um exemplo ajuda a esclarecer essa relação entre um Group objeto e o System.Text.RegularExpressions.CaptureCollection que é retornado pela Captures propriedade. O padrão (\b(\w+?)[,:;]?\s?)+[?.!] de expressão regular corresponde a frases inteiras. A expressão regular é definida como mostrado na tabela a seguir.

Nesse padrão de expressão regular, o subpattern (\w+?) foi projetado para corresponder a várias palavras dentro de uma frase. No entanto, o valor do Group objeto representa apenas a última correspondência que (\w+?) captura, enquanto a Captures propriedade retorna um CaptureCollection que representa todo o texto capturado. Como a saída mostra, o CaptureCollection segundo grupo de captura contém quatro objetos. O último deles corresponde ao Group objeto.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"(\b(\w+?)[,:;]?\s?)+[?.!]";
      string input = "This is one sentence. This is a second sentence.";

      Match match = Regex.Match(input, pattern);
      Console.WriteLine("Match: " + match.Value);
      int groupCtr = 0;
      foreach (Group group in match.Groups)
      {
         groupCtr++;
         Console.WriteLine("   Group {0}: '{1}'", groupCtr, group.Value);
         int captureCtr = 0;
         foreach (Capture capture in group.Captures)
         {
            captureCtr++;
            Console.WriteLine("      Capture {0}: '{1}'", captureCtr, capture.Value);
         }
      }   
   }
}
// The example displays the following output:
//       Match: This is one sentence.
//          Group 1: 'This is one sentence.'
//             Capture 1: 'This is one sentence.'
//          Group 2: 'sentence'
//             Capture 1: 'This '
//             Capture 2: 'is '
//             Capture 3: 'one '
//             Capture 4: 'sentence'
//          Group 3: 'sentence'
//             Capture 1: 'This'
//             Capture 2: 'is'
//             Capture 3: 'one'
//             Capture 4: 'sentence'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(\b(\w+?)[,:;]?\s?)+[?.!]"
      Dim input As String = "This is one sentence. This is a second sentence."

      Dim match As Match = Regex.Match(input, pattern)
      Console.WriteLine("Match: " + match.Value)
      Dim groupCtr As Integer = 0
      For Each group As Group In match.Groups
         groupCtr += 1
         Console.WriteLine("   Group {0}: '{1}'", groupCtr, group.Value)
         Dim captureCtr As Integer = 0
         For Each capture As Capture In group.Captures
            captureCtr += 1
            Console.WriteLine("      Capture {0}: '{1}'", captureCtr, capture.Value)
         Next
      Next   
   End Sub
End Module
' The example displays the following output:
'       Match: This is one sentence.
'          Group 1: 'This is one sentence.'
'             Capture 1: 'This is one sentence.'
'          Group 2: 'sentence'
'             Capture 1: 'This '
'             Capture 2: 'is '
'             Capture 3: 'one '
'             Capture 4: 'sentence'
'          Group 3: 'sentence'
'             Capture 1: 'This'
'             Capture 2: 'is'
'             Capture 3: 'one'
'             Capture 4: 'sentence'

Propriedades

Métodos

Aplica-se a