OverflowException OverflowException OverflowException OverflowException Class

Definición

Excepción que se produce cuando una operación aritmética, de conversión de tipo o de conversión de otra naturaleza en un contexto comprobado, da como resultado una sobrecarga.The exception that is thrown when an arithmetic, casting, or conversion operation in a checked context results in an overflow.

public ref class OverflowException : ArithmeticException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class OverflowException : ArithmeticException
type OverflowException = class
    inherit ArithmeticException
Public Class OverflowException
Inherits ArithmeticException
Herencia
Atributos

Comentarios

Se OverflowException produce una excepción en tiempo de ejecución en las siguientes condiciones:An OverflowException is thrown at run time under the following conditions:

  • Una operación aritmética genera un resultado que está fuera del intervalo del tipo de datos devuelto por la operación.An arithmetic operation produces a result that is outside the range of the data type returned by the operation. En el ejemplo siguiente se muestra OverflowException que se produce mediante una operación Int32 de multiplicación que desborda los límites del tipo.The following example illustrates the OverflowException that is thrown by a multiplication operation that overflows the bounds of the Int32 type.

    int value = 780000000;
    checked {
    try {
       // Square the original value.
       int square = value * value; 
       Console.WriteLine("{0} ^ 2 = {1}", value, square);
    }
    catch (OverflowException) {
       double square = Math.Pow(value, 2);
       Console.WriteLine("Exception: {0} > {1:E}.", 
                         square, Int32.MaxValue);
    } }
    // The example displays the following output:
    //       Exception: 6.084E+17 > 2.147484E+009.
    
    Dim value As Integer = 780000000
    Try
       ' Square the original value.
       Dim square As Integer = value * value 
       Console.WriteLine("{0} ^ 2 = {1}", value, square)
    Catch e As OverflowException
       Dim square As Double = Math.Pow(value, 2)
       Console.WriteLine("Exception: {0} > {1:E}.", _
                         square, Int32.MaxValue)
    End Try
    ' The example displays the following output:
    '       Exception: 6.084E+17 > 2.147484E+009.
    
  • Una operación de conversión o conversión intenta realizar una conversión de restricción y el valor del tipo de datos de origen está fuera del intervalo del tipo de datos de destino.A casting or conversion operation attempts to perform a narrowing conversion, and the value of the source data type is outside the range of the target data type. En el ejemplo siguiente se muestra OverflowException que se produce al intentar convertir un valor de byte sin signo grande en un valor de byte con signo.The following example illustrates the OverflowException that is thrown by the attempt to convert a large unsigned byte value to a signed byte value.

    byte value = 241;
    checked {
    try {
       sbyte newValue = (sbyte) value;
       Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", 
                         value.GetType().Name, value, 
                         newValue.GetType().Name, newValue);
    }
    catch (OverflowException) {
       Console.WriteLine("Exception: {0} > {1}.", value, SByte.MaxValue);
    } }                            
    // The example displays the following output:
    //       Exception: 241 > 127.
    
    Dim value As Byte = 241
    Try
       Dim newValue As SByte = (CSByte(value))
       Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                         value.GetType().Name, value, _
                         newValue.GetType().Name, newValue)
    Catch e As OverflowException
       Console.WriteLine("Exception: {0} > {1}.", value, SByte.MaxValue)
    End Try                            
    ' The example displays the following output:
    '       Exception: 241 > 127.
    

En cada caso, el resultado de la operación es un valor que es menor que la MinValue propiedad o mayor que la MaxValue propiedad del tipo de datos resultante de la operación.In each case, the result of the operation is a value that is less than the MinValue property or greater than the MaxValue property of the data type that results from the operation.

Para que la operación aritmética, de conversión o de conversión produzca OverflowExceptionuna excepción, la operación debe realizarse en un contexto comprobado.For the arithmetic, casting, or conversion operation to throw an OverflowException, the operation must occur in a checked context. De forma predeterminada, se comprueban las operaciones aritméticas y los desbordamientos en Visual Basic; en C#, no lo son.By default, arithmetic operations and overflows in Visual Basic are checked; in C#, they are not. Si la operación se produce en un contexto no comprobado, el resultado se trunca descartando los bits de orden superior que no caben en el tipo de destino.If the operation occurs in an unchecked context, the result is truncated by discarding any high-order bits that do not fit into the destination type. En el ejemplo siguiente se muestra una conversión no comprobada en C#.The following example illustrates such an unchecked conversion in C#. Repite el ejemplo anterior en un contexto no comprobado.It repeats the previous example in an unchecked context.

byte value = 241;
try {
   sbyte newValue = (sbyte) value;
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", 
                     value.GetType().Name, value, 
                     newValue.GetType().Name, newValue);
}
catch (OverflowException) {
   Console.WriteLine("Exception: {0} > {1}.", value, SByte.MaxValue);
}
// The example displays the following output:
//       Converted the Byte value 241 to the SByte value -15.

Las siguientes instrucciones del lenguaje intermedio de Microsoft (MSIL) OverflowExceptioninician una:The following Microsoft intermediate language (MSIL) instructions throw an OverflowException:

  • add.ovf. >con<signoadd.ovf. <signed>

  • conv.ovf. paraescribir<>conv.ovf. <to type>

  • conv.ovf. paraescribir<>.unconv.ovf. <to type> .un

  • mul.ovf. <type>mul.ovf. <type>

  • sub.ovf. <type>sub.ovf. <type>

  • newarr

OverflowExceptionusa HRESULT COR_E_OVERFLOW, que tiene el valor 0x80131516.OverflowException uses the HRESULT COR_E_OVERFLOW, which has the value 0x80131516.

Para obtener una lista de valores de propiedad iniciales de una instancia de OverflowException, consulte el OverflowException constructores.For a list of initial property values for an instance of OverflowException, see the OverflowException constructors.

Constructores

OverflowException() OverflowException() OverflowException() OverflowException()

Inicializa una nueva instancia de la clase OverflowException.Initializes a new instance of the OverflowException class.

OverflowException(SerializationInfo, StreamingContext) OverflowException(SerializationInfo, StreamingContext) OverflowException(SerializationInfo, StreamingContext) OverflowException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase OverflowException con datos serializados.Initializes a new instance of the OverflowException class with serialized data.

OverflowException(String) OverflowException(String) OverflowException(String) OverflowException(String)

Inicializa una nueva instancia de la clase OverflowException con el mensaje de error especificado.Initializes a new instance of the OverflowException class with a specified error message.

OverflowException(String, Exception) OverflowException(String, Exception) OverflowException(String, Exception) OverflowException(String, Exception)

Inicializa una nueva instancia de la clase OverflowException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.Initializes a new instance of the OverflowException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Propiedades

Data Data Data Data

Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Obtiene la instancia Exception que produjo la excepción actual.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Obtiene un mensaje que describe la excepción actual.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Obtiene el método que produjo la excepción actual.Gets the method that throws the current exception.

(Inherited from Exception)

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Cuando se reemplaza en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Cuando se reemplaza en una clase derivada, establece SerializationInfo con información sobre la excepción.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

Obtiene el tipo de tiempo de ejecución de la instancia actual.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Crea y devuelve una representación de cadena de la excepción actual.Creates and returns a string representation of the current exception.

(Inherited from Exception)

Eventos

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Se aplica a

Consulte también: