Encoding.DecoderFallback Property

 

Gets or sets the DecoderFallback object for the current Encoding object.

Namespace:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

[ComVisibleAttribute(false)]
public DecoderFallback DecoderFallback { get; set; }

Property Value

Type: System.Text.DecoderFallback

The decoder fallback object for the current Encoding object.

Exception Condition
ArgumentNullException

The value in a set operation is null.

InvalidOperationException

A value cannot be assigned in a set operation because the current Encoding object is read-only.

The DecoderFallback object represents an error handler that is invoked when an encoded byte sequence cannot be decoded into a character. Any one of the following handler types is supported:

  • A best-fit fallback handler, which replaces bytes that cannot be decoded with some suitable replacement character.

  • A replacement fallback handler, which replaces bytes that cannot be decoded with some arbitrary replacement character. The .NET Framework includes one replacement fallback handler, DecoderFallback, which by default replaces bytes that cannot be decoded with a question mark ("?") character.

  • An exception fallback handler, which throws an exception when bytes cannot be decoded. The .NET Framework includes one exception fallback handler, DecoderExceptionFallback, which throws a DecoderFallbackException when bytes cannot be decoded.

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top
Show: