Export (0) Print
Expand All

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
)

Parameters

replacement
Type: System.String

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

ExceptionCondition
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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft