Regex.Replace Method (String, MatchEvaluator, Int32)

Replaces up to a specified number of occurrences of a pattern defined by the regular expression specified in the Regex constructor with a replacement string, starting at the first character in the input string. A MatchEvaluator delegate is called at each match to evaluate the replacement.

Namespace: System.Text.RegularExpressions
Assembly: System (in system.dll)

String^ Replace (
	String^ input, 
	MatchEvaluator^ evaluator, 
	int count
public String Replace (
	String input, 
	MatchEvaluator evaluator, 
	int count
public function Replace (
	input : String, 
	evaluator : MatchEvaluator, 
	count : int
) : String



The string to be modified.


The MatchEvaluator which evaluates replacement at each step.


The maximum number of times the replacement will occur.

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.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0