OverflowException Osztály

Definíció

Névtér:

System

Szerelvény:

mscorlib.dll

Az a kivétel, amely akkor jelentkezik, ha egy ellenőrzött környezetben egy számtani, öntési vagy konvertálási művelet túlcsordulást eredményez.

public ref class OverflowException : ArithmeticException

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

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

Public Class OverflowException
Inherits ArithmeticException

Öröklődés

Object

Exception

SystemException

ArithmeticException

OverflowException

Attribútumok

SerializableAttribute ComVisibleAttribute

Megjegyzések

A OverflowException rendszer futásidőben a következő feltételek mellett dobja ki az egyiket:

• Az aritmetikai művelet olyan eredményt hoz létre, amely kívül esik a művelet által visszaadott adattípus tartományán. Az alábbi példa a OverflowException típus határait túlcsorduló szorzási művelet által elvetett műveletet szemlélteti 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.
  

• Az öntvény- vagy konverziós művelet szűkítő konverziót kísérel meg végrehajtani, és a forrásadattípus értéke kívül esik a céladattípus tartományán. Az alábbi példa azt OverflowException szemlélteti, hogy a nagy, aláíratlan bájtértékek aláírt bájtértékké való konvertálásának kísérlete milyen műveletet hajt végre.

  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.
  

A művelet eredménye minden esetben olyan érték, amely kisebb, mint a MinValue tulajdonság, vagy nagyobb, mint a MaxValue műveletből származó adattípus tulajdonsága.

Ahhoz, hogy az aritmetikai, öntési vagy konvertálási művelet eldobjon egy OverflowExceptionműveletet, a műveletnek ellenőrzött környezetben kell történnie. Alapértelmezés szerint a Visual Basic aritmetikai műveletei és túlcsordulásai vannak bejelölve, C# és F# esetén nem. Ha a művelet nem ellenőrzött környezetben történik, a rendszer csonkolja az eredményt a céltípusba nem illeszkedő, nagy megrendelésű bitek elvetésével. Az alábbi példa egy ilyen nem ellenőrzött átalakítást mutat be C# vagy F# nyelven. Megismétli az előző példát egy nem ellenőrzött környezetben.

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.

Az alábbi Microsoft köztes nyelv (MSIL) utasításai OverflowException:

• add.ovf. <Aláírt>

• conv.ovf. <a beíráshoz>

• conv.ovf. <a beíráshoz>.un

• mul.ovf. <Típus>

• sub.ovf. <Típus>

• newarr

OverflowException A HRESULT COR_E_OVERFLOW használja, amelynek értéke 0x80131516.

A OverflowException példány kezdeti tulajdonságainak listájáért tekintse meg a OverflowException konstruktorokat.

Konstruktorok

Name	Description
OverflowException()	Inicializálja a OverflowException osztály új példányát.
OverflowException(SerializationInfo, StreamingContext)	Inicializálja az OverflowException osztály új példányát szerializált adatokkal.
OverflowException(String, Exception)	Inicializálja az OverflowException osztály új példányát egy megadott hibaüzenettel és a kivétel okaként szolgáló belső kivételre mutató hivatkozással.
OverflowException(String)	Inicializálja az OverflowException osztály új példányát egy megadott hibaüzenettel.

Tulajdonságok

Name	Description
Data	Lekéri a kulcs-/érték párok gyűjteményét, amelyek további, felhasználó által definiált információkat biztosítanak a kivételről. (Öröklődés forrása Exception)
HelpLink	Lekéri vagy beállítja a kivételhez társított súgófájlra mutató hivatkozást. (Öröklődés forrása Exception)
HResult	Lekéri vagy beállítja a HRESULT-ot, egy kódolt numerikus értéket, amely egy adott kivételhez van hozzárendelve. (Öröklődés forrása Exception)
InnerException	Lekéri az Exception aktuális kivételt okozó példányt. (Öröklődés forrása Exception)
Message	Az aktuális kivételt leíró üzenet jelenik meg. (Öröklődés forrása Exception)
Source	Lekéri vagy beállítja az alkalmazás vagy a hibát okozó objektum nevét. (Öröklődés forrása Exception)
StackTrace	Lekéri a hívásverem közvetlen kereteinek sztringképét. (Öröklődés forrása Exception)
TargetSite	Lekéri az aktuális kivételt okozó metódust. (Öröklődés forrása Exception)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBaseException()	Ha egy származtatott osztály felül van bírálva, egy Exception vagy több későbbi kivétel kiváltó okát adja vissza. (Öröklődés forrása Exception)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Ha felül van bírálva egy származtatott osztályban, a SerializationInfo kivétel adatait adja meg. (Öröklődés forrása Exception)
GetType()	Lekéri az aktuális példány futtatókörnyezeti típusát. (Öröklődés forrása Exception)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Létrehozza és visszaadja az aktuális kivétel sztring-ábrázolását. (Öröklődés forrása Exception)

esemény

Name	Description
SerializeObjectState	Akkor fordul elő, ha a kivétel szerializálva van egy kivételállapot-objektum létrehozásához, amely szerializált adatokat tartalmaz a kivételről. (Öröklődés forrása Exception)

Lásd még

• Exception
• Kivételek kezelése és kivetése