This documentation is archived and is not being maintained.

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

Replaces all occurrences of a pattern defined by a specified regular expression with a specified replacement character string, starting at the first character in the input string. Options can be specified to modify matching behavior.

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

static String^ Replace (
	String^ input, 
	String^ pattern, 
	String^ replacement, 
	RegexOptions options
public static String Replace (
	String input, 
	String pattern, 
	String replacement, 
	RegexOptions options
public static function Replace (
	input : String, 
	pattern : String, 
	replacement : String, 
	options : RegexOptions
) : String



The string to modify.


The regular expression pattern to match.


The replacement string.


A bitwise OR combination of RegexOption enumeration values.

Return Value

The modified string.

The static Replace methods are equivalent to constructing a Regex object with the specified regular expression pattern and calling the instance method Replace. The static methods are provided to allow an isolated, single use of a regular expression without explicitly creating a Regex object.

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