Match.Result(String) Método

Referencia

Definición

Espacio de nombres:: System.Text.RegularExpressions

Ensamblado:: System.Text.RegularExpressions.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve la expansión del patrón de reemplazo especificado.

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

Parámetros

replacement: String

Patrón de reemplazo que se va a utilizar.

Devoluciones

String

Versión expandida del parámetro replacement.

Excepciones

ArgumentNullException

replacement es null.

NotSupportedException

No se permite la expansión para este modelo.

Ejemplos

En el ejemplo siguiente se reemplazan los guiones que comienzan y terminan una expresión paréntesis por paréntesis.

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)

El patrón de la expresión regular --(.+?)-- se interpreta como se muestra en la tabla siguiente.

Modelo	Descripción
`--`	Coincide con dos guiones.
`(.+?)`	Coincide con cualquier carácter una o varias veces, pero tantas veces como sea posible. Este es el primer grupo de captura.
`--`	Coincide con dos guiones.

Tenga en cuenta que el patrón --(.+?)-- de expresión regular usa el cuantificador diferido +?. Si se usara el cuantificador + expansivo en su lugar, el motor de expresiones regulares encontraría solo una coincidencia en la cadena de entrada.

La cadena ($1) de reemplazo reemplaza la coincidencia con el primer grupo capturado, que se incluye entre paréntesis.

Comentarios

Mientras que el Regex.Replace método reemplaza todas las coincidencias de una cadena de entrada por un patrón de reemplazo especificado, el Result método reemplaza una sola coincidencia por un patrón de reemplazo especificado. Dado que funciona en una coincidencia individual, también es posible realizar el procesamiento en la cadena coincidente antes de llamar al Result método .

El replacement parámetro es un patrón de reemplazo de expresiones regulares estándar. Puede constar de caracteres literales y sustituciones de expresiones regulares. Para obtener más información, consulte Substituciones.

Se aplica a