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

Observações

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 alcance do tipo de dado devolvido pela operação. O exemplo seguinte ilustra o OverflowException que é lançado por uma operação de multiplicação que ultrapassa os limites do Int32 tipo.

  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 fundição ou conversão tenta realizar uma conversão de estreito, e o valor do tipo de dado fonte está fora do intervalo do tipo de dado alvo. O exemplo seguinte ilustra o OverflowException que é lançado pela tentativa de converter um valor grande de byte não assinado num 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 inferior à MinValue propriedade ou superior à MaxValue propriedade do tipo de dados resultante da operação.

Para a operação aritmética, de casting ou de conversão para lançar um OverflowException, a operação deve ocorrer num contexto verificado. Por defeito, as operações aritméticas e os overflows no Visual Basic estão verificados; em C# e F#, não estão. Se a operação ocorrer num contexto não controlado, o resultado é truncado ao descartar quaisquer bits de ordem superior que não se encaixem no tipo de destino. O exemplo seguinte ilustra uma conversão não verificada em C# ou F#. Repete o exemplo anterior num contexto não verificado.

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 Microsoft linguagem intermédia (MSIL) geram um OverflowException:

• add.ovf. <assinado>

• conv.ovf. <para escrever>

• conv.ovf. <para escrever>.un

• mul.ovf. <Tipo>

• sub.ovf. <Tipo>

• newarr

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

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

Ver também

• Exception
• Exceções de Manuseamento e Lançamento