Modifica

EncoderReplacementFallback Constructors

  • Reference

Definition

Namespace:
System.Text
Assemblies:
mscorlib.dll, System.Text.Encoding.dll
Assembly:
System.Runtime.dll
Assembly:
System.Text.Encoding.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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()

Source:
EncoderReplacementFallback.cs
Source:
EncoderReplacementFallback.cs
Source:
EncoderReplacementFallback.cs

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)

Source:
EncoderReplacementFallback.cs
Source:
EncoderReplacementFallback.cs
Source:
EncoderReplacementFallback.cs

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

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.

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.

See also

Applies to