Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

GroupCollection.Item, propriété (Int32)

Permet l'accès à un membre de la collection via un index d'entiers.

Espace de noms :  System.Text.RegularExpressions
Assembly :  System (dans System.dll)

public Group this[
	int groupnum
] { get; }

Paramètres

groupnum
Type : System.Int32
Index de base zéro du membre de la collection à récupérer.

Valeur de propriété

Type : System.Text.RegularExpressions.Group
Membre de la collection spécifiée par groupnum.

Vous pouvez déterminer le nombre d'éléments dans la collection en récupérant la valeur de la propriété Count. Valeurs valides pour la plage de paramètre groupnum de 0 à un de moins que le nombre d'éléments dans la collection.

L'objet GroupCollection retourné par la propriété Match.Groups a toujours au moins un membre. Si le moteur d'expression régulière ne peut pas trouver de correspondances dans une chaîne d'entrée particulière, l'objet Group unique dans la collection a sa propriété Group.Success définie sur false et sa propriété Group.Value définie sur String.Empty.

Si groupnum n'est pas l'index d'un membre de la collection, ou si groupnum est l'index d'un groupe de capture qui n'a pas obtenu de correspondance dans la chaîne d'entrée, la méthode retourne un objet Group dont la propriété Group.Success est false et dont la propriété Group.Value est String.Empty.

L'exemple suivant définit une expression régulière qui se compose de deux groupes comptés. Le premier groupe capture un ou plusieurs chiffres consécutifs. Le deuxième groupe correspond à un caractère unique. Étant donné que le moteur d'expressions régulières recherche zéro ou une occurrence du premier groupe, il ne trouve pas toujours de correspondance même si la correspondance d'expression régulière réussit. L'exemple illustre ensuite le résultat lorsque la propriété Item[Int32] est utilisée pour extraire un groupe non apparié, un groupe correspondant et un groupe qui n'est pas défini dans l'expression régulière. L'exemple définit un modèle d'expression régulière (\d+)*(\w)\2, qui est interprété comme indiqué dans le tableau suivant.

Modèle

Description

(\d+)*

Mettre en correspondance avec une ou plusieurs occurrences d'un chiffre décimal. Il s'agit du premier groupe de capture. Mettre en correspondance avec ce modèle zéro ou une fois.

(\w)

Il s'agit du deuxième groupe de capture.

\k

Mettre en correspondance avec la chaîne capturée par le deuxième groupe de capture.


using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"(\d+)*(\w)\2";
      string input = "AA";
      Match match = Regex.Match(input, pattern);

      // Get the first named group.
      Group group1 = match.Groups[1];
      Console.WriteLine("Group 1 value: {0}", group1.Success ? group1.Value : "Empty");

      // Get the second named group.
      Group group2 = match.Groups[2];
      Console.WriteLine("Group 2 value: {0}", group2.Success ? group2.Value : "Empty");

      // Get a non-existent group.
      Group group3 = match.Groups[3];
      Console.WriteLine("Group 3 value: {0}", group3.Success ? group3.Value : "Empty");
   }
}
// The example displays the following output:
//       Group 1 value: Empty
//       Group 2 value: A
//       Group 3 value: Empty


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft