EncoderReplacementFallback Constructor (String^)
Initializes a new instance of the EncoderReplacementFallback class using a specified replacement string.
Assembly: mscorlib (in mscorlib.dll)
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.
Available since 10
.NET Framework
Available since 2.0
DefaultString
EncoderReplacementFallback
EncoderReplacementFallback Overload
EncoderReplacementFallback Class
System.Text Namespace