OverflowException Clase

Definición

public ref class OverflowException : ArithmeticException

public class OverflowException : ArithmeticException

[System.Serializable]
public class OverflowException : ArithmeticException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class OverflowException : ArithmeticException

type OverflowException = class
    inherit ArithmeticException

[<System.Serializable>]
type OverflowException = class
    inherit ArithmeticException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type OverflowException = class
    inherit ArithmeticException

Public Class OverflowException
Inherits ArithmeticException

Herencia

Object

Exception

ArithmeticException

OverflowException

Herencia

Object

Exception

SystemException

ArithmeticException

OverflowException

Atributos

SerializableAttribute ComVisibleAttribute

Comentarios

Se produce una OverflowException en tiempo de ejecución en las condiciones siguientes:

• Una operación aritmética genera un resultado que está fuera del intervalo del tipo de datos devuelto por la operación. En el ejemplo siguiente se muestra el OverflowException que produce una operación de multiplicación que desborda los límites del tipo de Int32.

  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.
  

  open Checked
  
  let v = 780000000
  try
     // Square the original value.
     let square = v * v
     printfn $"{v} ^ 2 = {square}"
  with :? OverflowException ->
      let square = float v ** 2
      printfn $"Exception: {square} > {Int32.MaxValue:E}."
  // 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. En el ejemplo siguiente se muestra el OverflowException que produce el intento de convertir un valor de byte sin signo grande en un valor de byte con signo.

  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.
  

  open Checked
  
  let value = 241uy
  try
      let newValue = int8 value
      printfn $"Converted the {value.GetType().Name} value {value} to the {newValue.GetType().Name} value {newValue}."
  with :? OverflowException ->
      printfn $"Exception: {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 menor que la propiedad MinValue o mayor que la propiedad MaxValue del tipo de datos resultante de la operación.

Para que la operación aritmética, conversión o conversión inicie una OverflowException, la operación debe producirse en un contexto comprobado. De forma predeterminada, se comprueban las operaciones aritméticas y los desbordamientos en Visual Basic; en C# y F#, no lo son. Si la operación se produce en un contexto no comprobado, el resultado se trunca descartando los bits de orden alto que no caben en el tipo de destino. En el ejemplo siguiente se muestra una conversión no desactivada en C# o F#. Repite el ejemplo anterior en un contexto no comprobado.

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.

let value = 241uy
try
    let newValue = int8 value
    printfn $"Converted the {value.GetType().Name} value {value} to the {newValue.GetType().Name} value {newValue}."
with :? OverflowException ->
    printfn $"Exception: {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) inician una OverflowException:

• add.ovf. < > firmados

• conv.ovf. <escribir>

• conv.ovf. <para escribir>.un

• de tipo

• de tipo

• newarr

OverflowException usa el COR_E_OVERFLOW HRESULT, que tiene el valor 0x80131516.

Para obtener una lista de valores de propiedad iniciales para una instancia de OverflowException, vea los constructores de OverflowException.

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• Exception
• control e inicio de excepciones