Match.Result(String) Método
Definición
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
Versión expandida del parámetro replacement
.
Excepciones
replacement
es null
.
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.