OverflowException Třída

Definice

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

Dědičnost

Object

Exception

ArithmeticException

OverflowException

Dědičnost

Object

Exception

SystemException

ArithmeticException

OverflowException

Atributy

SerializableAttribute ComVisibleAttribute

Poznámky

OverflowException je vyvolán za běhu za následujících podmínek:

• Aritmetická operace vytvoří výsledek, který je mimo rozsah datového typu vráceného operací. Následující příklad znázorňuje OverflowException, který je vyvolán operací násobení, která přeteče hranice Int32 typu.

  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.
  

• Operace přetypování nebo převodu se pokusí provést zužující převod a hodnota zdrojového datového typu je mimo rozsah cílového datového typu. Následující příklad ukazuje OverflowException, který je vyvolán pokusem o převod velké nepodepsané bajtové hodnoty na podepsanou bajtovou hodnotu.

  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.
  

V každém případě je výsledkem operace hodnota, která je menší než MinValue vlastnost nebo větší než MaxValue vlastnost datového typu, která je výsledkem operace.

Aby operace aritmetika, přetypování nebo převodu vyvolat OverflowException, musí k operaci dojít v kontrolovaném kontextu. Ve výchozím nastavení jsou zaškrtnuty aritmetické operace a přetečení v jazyce Visual Basic; v jazyce C# a F# nejsou. Pokud k operaci dojde v nezaškrtnutém kontextu, výsledek se zkrátí tak, že zahodí všechny bity s vysokým pořadím, které se nevejdou do cílového typu. Následující příklad znázorňuje takový nezaškrtnutý převod v jazyce C# nebo F#. Předchozí příklad se opakuje v nezaškrtnutém kontextu.

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.

Následující pokyny jazyka MSIL (Microsoft Intermediate Language) vyvolá OverflowException:

• add.ovf. <podepsaných>

• conv.ovf. <zadat>

• conv.ovf. <zadat>.un

• typ mul.ovf.<>

• typ sub.ovf.<>

• newarr

OverflowException používá COR_E_OVERFLOW HRESULT, který má hodnotu 0x80131516.

Seznam počátečních hodnot vlastností pro instanci OverflowExceptionnaleznete v OverflowException konstruktory.

Konstruktory

Vlastnosti

Metody

Událost

Platí pro

Viz také

• Exception
• zpracování a vyvolání výjimek