Regex, classe

La classe System.String inclut plusieurs méthodes de comparaison et recherche que vous pouvez utiliser pour exécuter les critères spéciaux avec le texte. Par exemple, les méthodes String.Contains, String.EndsWith et String.StartsWith déterminent si une instance de chaîne contient une sous-chaîne spécifiée ; et les méthodes String.IndexOf, String.IndexOfAny, String.LastIndexOf et String.LastIndexOfAny retournent la position de départ d'une sous-chaîne spécifiée dans une chaîne. Utilisez les méthodes de la classe System.String lorsque vous recherchez une chaîne spécifique. Utilisez la classe Regex lorsque vous recherchez un modèle spécifique dans une chaîne. Pour plus d'informations et d'exemples, consultez Expressions régulières du .NET Framework.

Après avoir défini un modèle d'expression régulière, vous pouvez le fournir au moteur des expressions régulières de deux façons.

• En instanciant un objet Regex qui représente l'expression régulière. Pour ce faire, vous devez passer le modèle d'expression régulière à un constructeur Regex. Un objet Regex est immuable ; lorsque vous instanciez un objet Regex avec une expression régulière, l'expression régulière de cet objet ne peut pas être modifiée.

• En fournissant à la fois l'expression régulière et le texte à rechercher à une méthode Regexstatic (Shared en Visual Basic). Cela vous permet d'utiliser une expression régulière sans créer explicitement un objet Regex.

Toutes les méthodes d'identification de modèle Regex incluent des surcharges statiques et d'instance à la fois.

Le moteur des expressions régulières doit compiler un modèle particulier pour que celui-ci puisse être utilisé. Étant donné que les objets Regex sont immuables, c'est une procédure unique qui se produit lorsqu'un constructeur de classe Regex ou une méthode statique est appelé. Pour éviter de compiler une expression régulière unique à plusieurs reprises, le moteur des expressions régulières met en cache les expressions régulières compilées utilisées dans les appels de méthode statique. En conséquence, les méthodes utilisant des critères spéciaux d'expression régulière offrent une performance comparable aux méthodes statique et d'instance.

Important
Dans le .NET Framework versions 1.0 et 1.1, toutes les expressions régulières compilées ont été mises en cache, qu'elles aient été utilisées en appels de méthode statique ou d'instance. À partir du .NET Framework 2.0, seules les expressions régulières utilisées dans les appels de méthode statique sont mises en cache.

Toutefois, le système de la mise en cache implémenté par le moteur des expressions régulières peut affecter de façon défavorable la performance dans les deux cas suivants :

• Lorsque vous utilisez des appels de méthode statique avec un grand nombre d'expressions régulières. Par défaut, le moteur des expressions régulières met en cache les 15 dernières expressions régulières statiques. Si votre application utilise plus de 15 expressions régulières statiques, certaines expressions régulières doivent être recompilées. Pour empêcher cette recompilation, vous pouvez augmenter la propriété Regex.CacheSize à une valeur appropriée.

• Lorsque votre application instancie de nouveaux objets Regex avec les expressions régulières compilées précédemment. Par exemple, le code suivant définit une expression régulière pour trouver des mots dupliqués dans les lignes individuelles d'un flux de texte. Bien que l'exemple utilise une expression régulière unique, il instancie un nouvel objet Regex pour traiter chaque ligne de texte. Cela provoque la recompilation de l'expression régulière avec chaque itération de la boucle.

  C#

  VB

  Copier

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

  Pour empêcher la recompilation, l'application doit instancier un objet Regex unique qui est accessible à tout le code qui le requiert, comme indiqué dans l'exemple réécrit suivant.

  C#

  VB

  Copier

  
  StreamReader sr = new StreamReader(filename);
  string input;
  string pattern = @"\b(\w+)\s\1\b";
  Regex rgx = new Regex(pattern, RegexOptions.IgnoreCase);
  
  while (sr.Peek() >= 0)
  {
     input = sr.ReadLine();
     MatchCollection matches = rgx.Matches(input);
     if (matches.Count > 0)
     {
        Console.WriteLine("{0} ({1} matches):", input, matches.Count);
        foreach (Match match in matches)
           Console.WriteLine("   " + match.Value);
     }
  }
  sr.Close();   
  
  
  

Si vous décidez d'instancier un objet Regex et d'appeler ses méthodes ou des méthodes statiques, la classe Regex offre les fonctionnalités de critères spéciaux suivantes :

• Validation d'une correspondance. Vous appelez la méthode IsMatch pour déterminer si une correspondance est présente.

• Récupération d'une correspondance unique. Vous appelez la méthode Match pour récupérer un objet Match qui représente la première correspondance dans une chaîne ou dans une partie d'une chaîne. Les correspondances suivantes peuvent être récupérées en appelant la méthode Match.NextMatch.

• Récupération de toutes les correspondances. Vous appelez la méthode Matches pour récupérer un objet System.Text.RegularExpressions.MatchCollection qui représente toutes les correspondances trouvées dans une chaîne ou dans une partie d'une chaîne.

• Remplacement de texte correspondant. Vous appelez la méthode Replace pour remplacer le texte correspondant. Le texte de remplacement peut également être défini par une expression régulière. De plus, quelques-unes des méthodes Replace incluent un paramètre MatchEvaluator qui vous permet de définir par programmation le texte de remplacement.

• Création d'un tableau de chaînes formé de parties d'une chaîne d'entrée. Vous appelez la méthode Split pour fractionner une chaîne d'entrée aux positions définies par l'expression régulière.

En plus de ses méthodes utilisant des critères spéciaux, la classe Regex inclut plusieurs méthodes à usage déterminé :

• La méthode Escape échappe tous les caractères qui peuvent être interprétés comme opérateurs d'expression régulière dans une expression régulière ou une chaîne d'entrée.

• La méthode Unescape supprime ces caractères d'échappement.

• La méthode CompileToAssembly crée un assembly qui contient des expressions régulières prédéfinies. Le .NET Framework contient des exemples de ces assemblys à objectifs spécifiques dans l'espace de noms System.Web.RegularExpressions.