Export (0) Print
Expand All

OverflowException Class

The exception that is thrown when an arithmetic, casting, or conversion operation in a checked context results in an overflow.

For a list of all members of this type, see OverflowException Members.

System.Object
   System.Exception
      System.SystemException
         System.ArithmeticException
            System.OverflowException

[Visual Basic]
<Serializable>
Public Class OverflowException
   Inherits ArithmeticException
[C#]
[Serializable]
public class OverflowException : ArithmeticException
[C++]
[Serializable]
public __gc class OverflowException : public ArithmeticException
[JScript]
public
   Serializable
class OverflowException extends ArithmeticException

Thread Safety

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

Remarks

In languages that detect overflow, OverflowException is the exception that gets thrown. For example, in C#, the checked keyword is used to detect overflow conditions. An OverflowException exception occurs only in a checked context.

The following Microsoft intermediate language (MSIL) instructions throw OverflowException:

  • add.ovf.<signed>
  • conv.ovf.<to type>
  • conv.ovf.<to type>.un
  • mul.ovf.<type>
  • sub.ovf.<type>
  • newarr

For a result from an integral or decimal-type arithmetic operation or conversion that is outside the range of the destination type:

  • In a checked context, a compile-time error occurs if the operation is a constant expression. Otherwise, an OverflowException is thrown if the operation is performed at run-time.
  • In an unchecked context, the result is truncated by discarding any high-order bits that do not fit in the destination type.

OverflowException uses the HRESULT COR_E_OVERFLOW, that has the value 0x80131516.

For a list of initial property values for an instance of OverflowException, see the OverflowException constructors.

Requirements

Namespace: System

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

Assembly: Mscorlib (in Mscorlib.dll)

See Also

OverflowException Members | System Namespace | Exception | Handling and Throwing Exceptions

Show:
© 2014 Microsoft