DecoderFallbackException Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
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
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.) |
| HelpLink | Gets or sets a link to the help file associated with this 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.) |
| ParamName | Gets the name of the parameter that causes this exception. (Inherited from ArgumentException.) |
| Source | Gets or sets the name of the application or the object that causes the error. (Inherited from Exception.) |
| 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.