DecoderFallbackException Class
The exception that is thrown when a decoder fallback operation fails. This class cannot be inherited.
System::Exception
System::SystemException
System::ArgumentException
System.Text::DecoderFallbackException
Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)
The DecoderFallbackException type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() ![]() | DecoderFallbackException() | Initializes a new instance of the DecoderFallbackException class. |
![]() ![]() ![]() | DecoderFallbackException(String) | Initializes a new instance of the DecoderFallbackException class. A parameter specifies the error message. |
![]() ![]() ![]() | DecoderFallbackException(String, Exception) | Initializes a new instance of the DecoderFallbackException class. Parameters specify the error message and the inner exception that is the cause of this exception. |
![]() ![]() ![]() | DecoderFallbackException(String, array<Byte>, Int32) | Initializes a new instance of the DecoderFallbackException class. Parameters specify the error message, the array of bytes being decoded, and the index of the byte that cannot be decoded. |
| Name | Description | |
|---|---|---|
![]() ![]() ![]() | BytesUnknown | Gets the input byte sequence that caused the exception. |
![]() ![]() ![]() | Data | Gets a collection of key/value pairs that provide additional user-defined information about the exception. (Inherited from Exception.) |
![]() ![]() ![]() | HResult | Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Inherited from Exception.) |
![]() ![]() ![]() | Index | Gets the index position in the input byte sequence of the byte that caused the exception. |
![]() ![]() ![]() | InnerException | Gets the Exception instance that caused the current exception. (Inherited from Exception.) |
![]() ![]() ![]() | Message | Gets the error message and the parameter name, or only the error message if no parameter name is set. (Inherited from ArgumentException.) |
![]() ![]() ![]() | StackTrace | Gets a string representation of the frames on the call stack at the time the current exception was thrown. (Inherited from Exception.) |
| Name | Description | |
|---|---|---|
![]() ![]() ![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() ![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() ![]() | GetBaseException | When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Inherited from Exception.) |
![]() ![]() ![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() ![]() ![]() | GetType | Gets the runtime type of the current instance. (Inherited from Exception.) |
![]() ![]() ![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() ![]() ![]() | ToString | Creates and returns a string representation of the current exception. (Inherited from Exception.) |
When using the standard decoders, a DecoderFallbackException is thrown only if an attempt to decode a sequence of bytes fails and the value of the throwOnInvalidBytes argument was set to true in the Encoding implementation's class constructor.
The following example provides a possible handler for a DecoderFallbackException. It decodes a UTF8-encoded string in which two bytes have been modified so that they cannot be successfully decoded. When the exception handler is invoked, it decodes the byte array on a byte-by-byte basis and substitutes the asterisk (*) character for any bytes that cannot be successfully decoded.
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

