OverflowException Klas

Definitie

Naamruimte:

System

Assembly:

mscorlib.dll

De uitzondering die wordt gegenereerd wanneer een rekenkundige, cast- of conversiebewerking in een gecontroleerde context resulteert in een overloop.

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

Overname

Object

Exception

SystemException

ArithmeticException

OverflowException

Kenmerken

SerializableAttribute ComVisibleAttribute

Opmerkingen

Er OverflowException wordt een op runtime gegenereerd onder de volgende omstandigheden:

• Een rekenkundige bewerking produceert een resultaat dat buiten het bereik van het gegevenstype valt dat door de bewerking wordt geretourneerd. In het volgende voorbeeld ziet u de OverflowException bewerking die wordt gegenereerd door een vermenigvuldigingsbewerking die de grenzen van het Int32 type overloopt.

  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.
  

• Een cast-bewerking of conversiebewerking probeert een narrowing conversie uit te voeren en de waarde van het brongegevenstype valt buiten het bereik van het doelgegevenstype. In het volgende voorbeeld ziet u hoe deze OverflowException wordt gegenereerd door de poging om een grote niet-ondertekende bytewaarde te converteren naar een ondertekende bytewaarde.

  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.
  

In elk geval is het resultaat van de bewerking een waarde die kleiner is dan de MinValue eigenschap of groter is dan de MaxValue eigenschap van het gegevenstype dat het resultaat is van de bewerking.

Voor de rekenkundige bewerking, cast- of conversiebewerking om een OverflowExceptionte genereren, moet de bewerking plaatsvinden in een gecontroleerde context. Rekenkundige bewerkingen en overloop in Visual Basic worden standaard gecontroleerd; in C# en F# zijn ze niet. Als de bewerking plaatsvindt in een niet-gecontroleerd context, wordt het resultaat afgekapt door alle bits in hoge volgorde te verwijderen die niet in het doeltype passen. In het volgende voorbeeld ziet u een dergelijke niet-gecontroleerd conversie in C# of F#. Het vorige voorbeeld wordt herhaald in een niet-gecontroleerd context.

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.

De volgende Microsoft instructies voor tussenliggende taal (MSIL) geven een OverflowException:

• add.ovf. <Ondertekend>

• conv.ovf. <om te typen>

• conv.ovf. <om te typen>.un

• mul.ovf. <Type>

• sub.ovf. <Type>

• newarr

OverflowException maakt gebruik van de HRESULT-COR_E_OVERFLOW, met de waarde 0x80131516.

Voor een lijst van initiële eigenschapswaarden voor een exemplaar van OverflowException, zie de OverflowException-constructoren.

Constructors

Name	Description
OverflowException()	Initialiseert een nieuw exemplaar van de OverflowException klasse.
OverflowException(SerializationInfo, StreamingContext)	Initialiseert een nieuw exemplaar van de OverflowException klasse met geserialiseerde gegevens.
OverflowException(String, Exception)	Initialiseert een nieuw exemplaar van de OverflowException klasse met een opgegeven foutbericht en een verwijzing naar de binnenste uitzondering die de oorzaak van deze uitzondering is.
OverflowException(String)	Initialiseert een nieuw exemplaar van de OverflowException klasse met een opgegeven foutbericht.

Eigenschappen

Name	Description
Data	Hiermee haalt u een verzameling sleutel-waardeparen op die aanvullende door de gebruiker gedefinieerde informatie over de uitzondering bieden. (Overgenomen van Exception)
HelpLink	Hiermee haalt u een koppeling op naar het Help-bestand dat aan deze uitzondering is gekoppeld. (Overgenomen van Exception)
HResult	Hiermee wordt HRESULT opgehaald of ingesteld, een gecodeerde numerieke waarde die is toegewezen aan een specifieke uitzondering. (Overgenomen van Exception)
InnerException	Hiermee haalt u het Exception exemplaar op dat de huidige uitzondering heeft veroorzaakt. (Overgenomen van Exception)
Message	Hiermee wordt een bericht weergegeven waarin de huidige uitzondering wordt beschreven. (Overgenomen van Exception)
Source	Hiermee wordt de naam van de toepassing of het object dat de fout veroorzaakt, opgehaald of ingesteld. (Overgenomen van Exception)
StackTrace	Hiermee haalt u een tekenreeksweergave van de directe frames op de aanroepstack op. (Overgenomen van Exception)
TargetSite	Hiermee haalt u de methode op waarmee de huidige uitzondering wordt gegenereerd. (Overgenomen van Exception)

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetBaseException()	Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u de Exception hoofdoorzaak van een of meer volgende uitzonderingen. (Overgenomen van Exception)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetObjectData(SerializationInfo, StreamingContext)	Wanneer deze wordt overschreven in een afgeleide klasse, stelt u de SerializationInfo met informatie over de uitzondering in. (Overgenomen van Exception)
GetType()	Hiermee haalt u het runtimetype van het huidige exemplaar op. (Overgenomen van Exception)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Hiermee maakt en retourneert u een tekenreeksweergave van de huidige uitzondering. (Overgenomen van Exception)

gebeurtenis

Name	Description
SerializeObjectState	Treedt op wanneer een uitzondering wordt geserialiseerd om een uitzonderingsstatusobject te maken dat geserialiseerde gegevens over de uitzondering bevat. (Overgenomen van Exception)

Zie ook

• Exception
• Uitzonderingen verwerken en opwerpen