OverflowException Klass

Definition

Namnområde:

System

Sammansättning:

mscorlib.dll

Undantaget som utlöses när en aritmetik-, gjutnings- eller konverteringsåtgärd i en kontrollerad kontext resulterar i ett spill.

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

Arv

Object

Exception

SystemException

ArithmeticException

OverflowException

Attribut

SerializableAttribute ComVisibleAttribute

Kommentarer

En OverflowException genereras vid körning under följande förhållanden:

• En aritmetikåtgärd ger ett resultat som ligger utanför intervallet för den datatyp som returneras av åtgärden. I följande exempel visas det OverflowException som genereras av en multiplikationsåtgärd som spiller över gränserna för Int32 typen.

  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.
  

• En gjutnings- eller konverteringsåtgärd försöker utföra en begränsad konvertering och värdet för källdatatypen ligger utanför måldatatypens intervall. I följande exempel visas det OverflowException som genereras av försöket att konvertera ett stort osignerat bytevärde till ett signerat bytevärde.

  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.
  

I varje fall är resultatet av åtgärden ett värde som är mindre än MinValue egenskapen eller större än MaxValue egenskapen för den datatyp som är resultatet av åtgärden.

För att aritmetik-, gjutnings- eller konverteringsåtgärden ska utlösa en OverflowExceptionmåste åtgärden utföras i en kontrollerad kontext. Som standard kontrolleras aritmetiska åtgärder och spill i Visual Basic. I C# och F# är de inte det. Om åtgärden inträffar i en omarkerad kontext trunkeras resultatet genom att alla bitar i hög ordning som inte passar in i måltypen ignoreras. I följande exempel visas en sådan omarkerad konvertering i C# eller F#. Det upprepar föregående exempel i en omarkerad kontext.

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.

Följande instruktioner för Microsoft mellanliggande språk (MSIL) genererar en OverflowException:

• add.ovf. <Undertecknat>

• conv.ovf. <att skriva>

• conv.ovf. <att skriva>.un

• mul.ovf. <Typ>

• sub.ovf. <Typ>

• newarr

OverflowException använder HRESULT-COR_E_OVERFLOW, som har värdet 0x80131516.

För en lista över inledande egenskapsvärden för en instans av OverflowException, se i OverflowException-konstruktorn.

Konstruktorer

Name	Description
OverflowException()	Initierar en ny instans av OverflowException klassen.
OverflowException(SerializationInfo, StreamingContext)	Initierar en ny instans av OverflowException klassen med serialiserade data.
OverflowException(String, Exception)	Initierar en ny instans av OverflowException klassen med ett angivet felmeddelande och en referens till det inre undantaget som är orsaken till det här undantaget.
OverflowException(String)	Initierar en ny instans av OverflowException klassen med ett angivet felmeddelande.

Egenskaper

Name	Description
Data	Hämtar en samling nyckel/värde-par som ger ytterligare användardefinierad information om undantaget. (Ärvd från Exception)
HelpLink	Hämtar eller anger en länk till hjälpfilen som är associerad med det här undantaget. (Ärvd från Exception)
HResult	Hämtar eller anger HRESULT, ett kodat numeriskt värde som har tilldelats ett specifikt undantag. (Ärvd från Exception)
InnerException	Hämtar den Exception instans som orsakade det aktuella undantaget. (Ärvd från Exception)
Message	Hämtar ett meddelande som beskriver det aktuella undantaget. (Ärvd från Exception)
Source	Hämtar eller anger namnet på programmet eller objektet som orsakar felet. (Ärvd från Exception)
StackTrace	Hämtar en strängrepresentation av de omedelbara ramarna i anropsstacken. (Ärvd från Exception)
TargetSite	Hämtar den metod som utlöser det aktuella undantaget. (Ärvd från Exception)

Metoder

Name	Description
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetBaseException()	När den åsidosätts i en härledd klass returnerar den Exception som är rotorsaken till ett eller flera efterföljande undantag. (Ärvd från Exception)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetObjectData(SerializationInfo, StreamingContext)	När åsidosättas i en härledd klass anger du SerializationInfo med information om undantaget. (Ärvd från Exception)
GetType()	Hämtar körningstypen för den aktuella instansen. (Ärvd från Exception)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ToString()	Skapar och returnerar en strängrepresentation av det aktuella undantaget. (Ärvd från Exception)

Händelser

Name	Description
SerializeObjectState	Inträffar när ett undantag serialiseras för att skapa ett undantagstillståndsobjekt som innehåller serialiserade data om undantaget. (Ärvd från Exception)

Se även

• Exception
• Hantera och utlösa undantag