Match.Result(String) Méthode

Référence

Définition

Espace de noms:: System.Text.RegularExpressions

Assembly:: System.Text.RegularExpressions.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne l’extension du modèle de remplacement spécifié.

public:
 virtual System::String ^ Result(System::String ^ replacement);

public virtual string Result (string replacement);

abstract member Result : string -> string
override this.Result : string -> string

Public Overridable Function Result (replacement As String) As String

Paramètres

replacement: String

Modèle de remplacement à utiliser.

Retours

String

Version étendue du paramètre replacement.

Exceptions

ArgumentNullException

replacement a la valeur null.

NotSupportedException

Le déploiement n'est pas autorisé pour ce modèle.

Exemples

L’exemple suivant remplace les traits d’union qui commencent et terminent une expression parenthèse par des parenthèses.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "--(.+?)--";
      string replacement = "($1)";
      string input = "He said--decisively--that the time--whatever time it was--had come.";
      foreach (Match match in Regex.Matches(input, pattern))
      {
         string result = match.Result(replacement);
         Console.WriteLine(result);
      }
   }
}
// The example displays the following output:
//       (decisively)
//       (whatever time it was)

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "--(.+?)--"
      Dim replacement As String = "($1)"
      Dim input As String = "He said--decisively--that the time--whatever time it was--had come."
      For Each match As Match In Regex.Matches(input, pattern)
         Dim result As String = match.Result(replacement)
         Console.WriteLine(result)
      Next
   End Sub
End Module
' The example displays the following output:
'       (decisively)
'       (whatever time it was)

Le modèle d'expression régulière --(.+?)-- est interprété comme indiqué dans le tableau suivant.

Modèle	Description
`--`	Mettre en correspondance deux traits d’union.
`(.+?)`	Mettre en correspondance un ou plusieurs caractères, mais le plus souvent possible. Il s'agit du premier groupe de capture.
`--`	Mettre en correspondance deux traits d’union.

Notez que le modèle --(.+?)-- d’expression régulière utilise le quantificateur +?différé . Si le quantificateur + gourmand a été utilisé à la place, le moteur d’expression régulière ne trouverait qu’une seule correspondance dans la chaîne d’entrée.

La chaîne ($1) de remplacement remplace la correspondance par le premier groupe capturé, qui est placé entre parenthèses.

Remarques

Alors que la Regex.Replace méthode remplace toutes les correspondances dans une chaîne d’entrée par un modèle de remplacement spécifié, la Result méthode remplace une correspondance unique par un modèle de remplacement spécifié. Étant donné qu’elle fonctionne sur une correspondance individuelle, il est également possible d’effectuer le traitement sur la chaîne correspondante avant d’appeler la Result méthode.

Le replacement paramètre est un modèle de remplacement d’expression régulière standard. Il peut se composer de caractères littéraux et de substitutions d’expressions régulières. Pour plus d’informations, consultez Substitutions.

S’applique à