OverflowException Classe

Definição

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

Herança

Object

Exception

ArithmeticException

OverflowException

Herança

Object

Exception

SystemException

ArithmeticException

OverflowException

Atributos

SerializableAttribute ComVisibleAttribute

Comentários

Um OverflowException é lançado em tempo de execução sob as seguintes condições:

• Uma operação aritmética produz um resultado que está fora do intervalo do tipo de dados retornado pela operação. O exemplo a seguir ilustra a OverflowException gerada por uma operação de multiplicação que estouram os limites do tipo 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.
  

• Uma operação de conversão ou conversão tenta executar uma conversão de restrição e o valor do tipo de dados de origem está fora do intervalo do tipo de dados de destino. O exemplo a seguir ilustra a OverflowException gerada pela tentativa de converter um grande valor de bytes sem sinal em um valor de byte assinado.

  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.
  

Em cada caso, o resultado da operação é um valor menor que a propriedade MinValue ou maior que a propriedade MaxValue do tipo de dados resultante da operação.

Para que a operação aritmética, de conversão ou de conversão gere uma OverflowException, a operação deve ocorrer em um contexto verificado. Por padrão, as operações aritméticas e estouros no Visual Basic são verificados; em C# e F#, eles não são. Se a operação ocorrer em um contexto desmarcado, o resultado será truncado descartando os bits de alta ordem que não se encaixam no tipo de destino. O exemplo a seguir ilustra essa conversão desmarcada em C# ou F#. Ele repete o exemplo anterior em um contexto desmarcado.

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.

As seguintes instruções de MSIL (linguagem intermediária da Microsoft) lançam um OverflowException:

• add.ovf. <assinado>

• conv.ovf. <digitar>

• conv.ovf. <digitar>.un

• mul.ovf. <tipo>

• sub.ovf. <tipo>

• newarr

OverflowException usa o COR_E_OVERFLOW HRESULT, que tem o valor 0x80131516.

Para obter uma lista de valores de propriedade iniciais para uma instância de OverflowException, consulte os construtores de OverflowException.

Construtores

Propriedades

Métodos

Eventos

Aplica-se a

Confira também

• Exception
• de tratamento e geração de exceções