Group Klasse

Definition

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

Vererbung

Object

Capture

Group

Abgeleitet

System.Text.RegularExpressions.Match

Attribute

SerializableAttribute

Hinweise

Eine Erfassungsgruppe kann null, eine oder mehrere Zeichenfolgen in einer einzelnen Übereinstimmung aufgrund von Quantifizierern erfassen. (Weitere Informationen finden Sie unter Quantifizierer.) Alle Teilzeichenfolgen, die mit einer einzelnen Erfassungsgruppe übereinstimmen, sind in der Group.Captures Eigenschaft verfügbar. Auf Informationen über die letzte erfasste Teilzeichenfolge kann direkt über die Value eigenschaften Index zugegriffen werden. (Das heißt, die Group Instanz entspricht dem letzten Element der Auflistung, die von der Captures Eigenschaft zurückgegeben wird, was die letzte Erfassung widerspiegelt, die von der Aufnahmegruppe vorgenommen wurde.)

Ein Beispiel hilft, diese Beziehung zwischen einem Group Objekt und dem System.Text.RegularExpressions.CaptureCollection von der Captures Eigenschaft zurückgegebenen Objekt zu klären. Das Muster (\b(\w+?)[,:;]?\s?)+[?.!] für reguläre Ausdrücke entspricht ganzen Sätzen. Der reguläre Ausdruck wird entsprechend der Darstellung in der folgenden Tabelle definiert:

In diesem Muster für reguläre Ausdrücke ist der Unterpattern (\w+?) so konzipiert, dass er mit mehreren Wörtern innerhalb eines Satzes übereinstimmt. Der Wert des Group Objekts stellt jedoch nur die letzte Übereinstimmung dar, die (\w+?) erfasst wird, während die Captures Eigenschaft ein CaptureCollection Objekt zurückgibt, das den gesamten erfassten Text darstellt. Wie die Ausgabe zeigt, enthält die CaptureCollection zweite Aufnahmegruppe vier Objekte. Der letzte dieser Entspricht dem Group Objekt.

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'