EncoderReplacementFallback Constructors

Definition

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

Remarks

By default, the replacement string that is the value of this EncoderReplacementFallback object is "?".

See also

Applies to

.NET 9 ja muud versioonid
Toode Versioonid
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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 (string replacement);

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.

See also

Applies to

.NET 9 ja muud versioonid
Toode Versioonid
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0