Group Classe

Definizione

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

Ereditarietà

Object

Capture

Group

Derivato

System.Text.RegularExpressions.Match

Attributi

SerializableAttribute

Commenti

Un gruppo di acquisizione può acquisire zero, una o più stringhe in una singola corrispondenza a causa di quantificatori. Per altre informazioni, vedere Quantificatori. Tutte le sottostringhe corrispondenti a un singolo gruppo di acquisizione sono disponibili dalla Group.Captures proprietà . È possibile accedere alle informazioni sull'ultima sottostringa acquisita direttamente dalle Value proprietà e Index . Ovvero, l'istanza Group equivale all'ultimo elemento della raccolta restituita dalla Captures proprietà , che riflette l'ultima acquisizione eseguita dal gruppo di acquisizione.

Un esempio consente di chiarire questa relazione tra un Group oggetto e l'oggetto System.Text.RegularExpressions.CaptureCollection restituito dalla Captures proprietà . Il criterio di (\b(\w+?)[,:;]?\s?)+[?.!] espressione regolare corrisponde a intere frasi. L'espressione regolare è definita nel modo illustrato nella tabella seguente.

In questo modello di espressione regolare, il sottopattern (\w+?) è progettato per trovare una corrispondenza con più parole all'interno di una frase. Tuttavia, il valore dell'oggetto Group rappresenta solo l'ultima corrispondenza acquisita (\w+?) , mentre la Captures proprietà restituisce un CaptureCollection oggetto che rappresenta tutto il testo acquisito. Come illustrato nell'output, per CaptureCollection il secondo gruppo di acquisizione sono contenuti quattro oggetti. L'ultimo di questi corrisponde all'oggetto Group .

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'