EncoderReplacementFallback Constructor (String)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
)

Parameters

replacement
Type: System.String

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

Exception Condition
ArgumentNullException

replacement is null.

ArgumentException

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.

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top
Show: