This documentation is archived and is not being maintained.

Regex.Replace Method (String, String, MatchEvaluator, RegexOptions)

.NET Framework 1.1

Replaces all occurrences of a character pattern defined by a specified regular expression with a replacement character string starting at the first character. Options can be specified to modify matching behavior and a MatchEvaluator delegate is called at each match to evaluate the replacement.

[Visual Basic]
Overloads Public Shared Function Replace( _
   ByVal input As String, _
   ByVal pattern As String, _
   ByVal evaluator As MatchEvaluator, _
   ByVal options As RegexOptions _
) As String
public static string Replace(
 string input,
 string pattern,
 MatchEvaluator evaluator,
 RegexOptions options
public: static String* Replace(
 String* input,
 String* pattern,
 MatchEvaluator* evaluator,
 RegexOptions options
public static function Replace(
   input : String,
 pattern : String,
 evaluator : MatchEvaluator,
 options : RegexOptions
) : String;


The string to modify.
The regular expression pattern to match.
The MatchEvaluator which evaluates replacement at each step.
A bitwise OR combination of RegexOption enumeration values.

Return Value

The modified character string.


The MatchEvaluator type is a delegate that takes a single Match as input and returns a string. It is declared as follows:

public delegate String RegexMatchEvaluator(Match match);The delegate is called once per match during a replace.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Regex Class | Regex Members | System.Text.RegularExpressions Namespace | Regex.Replace Overload List