Class DecoderException

Namespace

ShapeShift

Assembly

ShapeShift.dll

The exception a decoder throws when its input is malformed.

public class DecoderException : Exception, ISerializable

Inheritance

object

Exception

DecoderException

Implements

ISerializable

Inherited Members

Exception.GetBaseException()

Exception.GetType()

Exception.ToString()

Exception.Data

Exception.HelpLink

Exception.HResult

Exception.InnerException

Exception.Message

Exception.Source

Exception.StackTrace

Exception.TargetSite

Exception.SerializeObjectState

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Remarks

This is how a format reports "these bytes are not valid", as distinct from ShapeShiftSerializationException, which reports that a structurally valid document does not match the shape being deserialized and carries the ShapeShiftPath to the value that failed.

A decoder reads attacker-controlled bytes, so every rejection must arrive here. An IndexOutOfRangeException, ArgumentOutOfRangeException, NullReferenceException, or an unbounded allocation escaping a decoder means a missing length or bounds check rather than a merely inconvenient exception type.

Constructors

DecoderException(string)

Initializes a new instance of the DecoderException class.

public DecoderException(string message)

Parameters

message string

The message that describes the malformed input.

DecoderException(string, Exception?)

Initializes a new instance of the DecoderException class.

public DecoderException(string message, Exception? innerException)

Parameters

message string

The message that describes the malformed input.

innerException Exception

The exception that revealed the input was malformed.