OverflowException Class (System)

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

.NET Framework Class Library

OverflowException Class

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

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

Syntax

Visual Basic (Declaration)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class OverflowException
    Inherits ArithmeticException

Visual Basic (Usage)

Dim instance As OverflowException

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class OverflowException : ArithmeticException

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class OverflowException : public ArithmeticException

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class OverflowException extends ArithmeticException

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class OverflowException extends ArithmeticException

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.

Inheritance Hierarchy

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

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.

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Reference

OverflowException Members
System Namespace
Exception Class

Other Resources

Handling and Throwing Exceptions