DecoderFallbackBuffer Class

DecoderFallbackBuffer Class


Passes a string to a decoding operation that is emitted instead of an output character because an input byte sequence cannot be decoded.

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

public abstract class DecoderFallbackBuffer
public abstract class DecoderFallbackBuffer
public abstract class DecoderFallbackBuffer


The .NET Framework provides a conversion failure-handling mechanism, called a fallback, if a conversion cannot be performed. All decoder fallbacks must implement a decoder fallback buffer, which is represented by a type derived from the DecoderFallbackBuffer class, that can pass a string to the conversion operation.

Fallbacks can employ different strategies for handling conversion failures. The fallback buffer for a decoder replacement fallback, for example, emits a substitute output string if an input byte sequence cannot be decoded. A fallback buffer is required even if the strategy implemented by a particular fallback does not require emitting data. For example, the fallback buffer for an encoder or decoder exception fallback is not used because the fallback throws an exception instead of producing output.




.NET Framework

Supported in: 2.0

Community Additions

© 2016 Microsoft