This documentation is archived and is not being maintained.

EncoderReplacementFallback Constructor (String)

Initializes a new instance of the EncoderReplacementFallback class using a specified replacement string.

Namespace:  System.Text
Assembly:  mscorlib (in mscorlib.dll)

public EncoderReplacementFallback(
	string replacement


Type: System.String

A string that is converted in an encoding operation in place of an input character that cannot be encoded.


replacement is null.


replacement contains an invalid surrogate pair. In other words, the surrogate does not consist of one high surrogate component followed by one low surrogate component.

The replacement parameter initializes the replacement string that is the value of this EncoderReplacementFallback object. You application must provide a replacement value that contains only characters that can be encoded in the target encoding. Otherwise, a recursive fallback results, causing an ArgumentException. For example, the fallback provided for an ASCIIEncoding object cannot include the character "¿" (U+00BF) because that character is itself not a valid ASCII character.

As a result of this, U+FFFD, which is a good choice for a fallback string for DecoderExceptionFallback, is not generally a good choice for this class. Also, the null character (U+0000) cannot be used in the fallback string.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0