DecoderExceptionFallbackBuffer Class

 

Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. This class cannot be inherited.

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

System::Object
  System.Text::DecoderFallbackBuffer
    System.Text::DecoderExceptionFallbackBuffer

public ref class DecoderExceptionFallbackBuffer sealed : DecoderFallbackBuffer

NameDescription
System_CAPS_pubmethodDecoderExceptionFallbackBuffer()

Initializes a new instance of the DecoderExceptionFallbackBuffer class.

NameDescription
System_CAPS_pubpropertyRemaining

Gets the number of characters in the current DecoderExceptionFallbackBuffer object that remain to be processed.(Overrides DecoderFallbackBuffer::Remaining.)

NameDescription
System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodFallback(array<Byte>^, Int32)

Throws DecoderFallbackException when the input byte sequence cannot be decoded. The nominal return value is not used. (Overrides DecoderFallbackBuffer::Fallback(array<Byte>^, Int32).)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetNextChar()

Retrieves the next character in the exception data buffer.(Overrides DecoderFallbackBuffer::GetNextChar().)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodMovePrevious()

Causes the next call to GetNextChar to access the exception data buffer character position that is prior to the current position.(Overrides DecoderFallbackBuffer::MovePrevious().)

System_CAPS_pubmethodReset()

Initializes all data and state information pertaining to this fallback buffer.(Inherited from DecoderFallbackBuffer.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

A common reason for an encoding or decoding operation to fail is if the underlying encoding class does not provide a mapping between a character and an equivalent byte sequence. If the input byte sequence cannot be converted to an output character, the decoding operation calls the Fallback method, which throws DecoderFallbackException.

The System.Text::DecoderFallbackBuffer class, which represents a data buffer used in a decoding operation, is the base class for the DecoderExceptionFallbackBuffer class. However, instead of a data buffer, the DecoderExceptionFallbackBuffer class represents a standard behavior in which an exception is thrown if a decoding operation fails. No actual data buffer exists, and the members designed to manipulate such a buffer do no significant work.

.NET Framework
Available since 2.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: