Group Classe

Définition

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

Héritage

Object

Capture

Group

Dérivé

System.Text.RegularExpressions.Match

Attributs

SerializableAttribute

Remarques

Un groupe de capture peut capturer zéro, un ou plusieurs chaînes dans une correspondance unique en raison de quantificateurs. (Pour plus d’informations, consultez Quantificateurs.) Toutes les sous-chaînes mises en correspondance par un seul groupe de capture sont disponibles à partir de la Group.Captures propriété. Les informations sur la dernière sous-chaîne capturée sont accessibles directement à partir des propriétés et Index des Value propriétés. (Autrement dit, l’instance Group équivaut au dernier élément de la collection retourné par la Captures propriété, qui reflète la dernière capture effectuée par le groupe de capture.)

Un exemple permet de clarifier cette relation entre un Group objet et celle System.Text.RegularExpressions.CaptureCollection retournée par la Captures propriété. Le modèle (\b(\w+?)[,:;]?\s?)+[?.!] d’expression régulière correspond à des phrases entières. L'expression régulière est définie comme indiqué dans le tableau suivant.

Dans ce modèle d’expression régulière, le sous-objet (\w+?) est conçu pour correspondre à plusieurs mots dans une phrase. Toutefois, la valeur de l’objet Group représente uniquement la dernière correspondance qui (\w+?) capture, tandis que la Captures propriété retourne un CaptureCollection texte capturé. Comme le montre la sortie, le CaptureCollection deuxième groupe de capture contient quatre objets. Le dernier de ces éléments correspond à l’objet 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'

Propriétés

Méthodes

S’applique à