EncoderReplacementFallback Constructors
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Initializes a new instance of the EncoderReplacementFallback class.
Overloads
EncoderReplacementFallback() |
Initializes a new instance of the EncoderReplacementFallback class. |
EncoderReplacementFallback(String) |
Initializes a new instance of the EncoderReplacementFallback class using a specified replacement string. |
EncoderReplacementFallback()
Initializes a new instance of the EncoderReplacementFallback class.
public:
EncoderReplacementFallback();
public EncoderReplacementFallback ();
Public Sub New ()
Remarks
By default, the replacement string that is the value of this EncoderReplacementFallback object is "?".
See also
Applies to
EncoderReplacementFallback(String)
Initializes a new instance of the EncoderReplacementFallback class using a specified replacement string.
public:
EncoderReplacementFallback(System::String ^ replacement);
public EncoderReplacementFallback (string replacement);
new System.Text.EncoderReplacementFallback : string -> System.Text.EncoderReplacementFallback
Public Sub New (replacement As String)
Parameters
- replacement
- String
A string that is converted in an encoding operation in place of an input character that cannot be encoded.
Exceptions
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.
Remarks
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.