OverflowException-Klasse

Eine OverflowException wird bei Laufzeit bei folgenden Bedingungen ausgelöst:

• Eine arithmetische Operation führt zu einem Ergebnis, das außerhalb des Datentypbereichs liegt, der vom Vorgang zurückgegeben wurde. Im folgenden Beispiel wird die OverflowException veranschaulicht, die von einer Multiplikationsoperation ausgelöst wird, die über die Grenzen des Int32-Typs überläuft.

  C#

  VB

  Kopieren

  
  int value = 780000000;
  checked {
  try {
     // Square the original value.
     int square = value * value; 
     Console.WriteLine("{0} ^ 3 = {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.
  
  
  

• Eine Umwandlungs- oder Konvertierungsoperation versucht, eine einschränkende Konvertierung auszuführen, und der Wert des Quelldatentyps liegt außerhalb des Bereichs des Zieldatentyps. Im folgenden Beispiel wird die OverflowException veranschaulicht, die durch den Versuch ausgelöst wird, einen großen Bytewert ohne Vorzeichen in einen Bytewert mit Vorzeichen zu konvertieren.

  C#

  VB

  Kopieren

  
  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.
  
  
  

In jedem Fall ist das Ergebnis der Operation ein Wert, der kleiner als die MinValue-Eigenschaft oder größer als die MaxValue-Eigenschaft des Datentyps ist, der sich aus der Operation ergibt.

Damit die Arithmetik-, Umwandlungs- oder Konvertierungsoperation eine OverflowException auslöst, muss die Operation in einem überprüften Kontext auftreten. Standardmäßig werden arithmetische Operationen und Überläufe in Visual Basic überprüft; in C# erfolgt keine Überprüfung. Wenn die Operation in einem nicht überprüften Kontext auftritt, wird das Ergebnis abgeschnitten, indem alle höherwertigen Bits ignoriert werden, die nicht in den Zieltyp passen. Im folgenden Beispiel wird eine solche nicht überprüfte Konvertierung in C# veranschaulicht. Dies ist eine Wiederholung des vorherigen Beispiels in einem nicht überprüften 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.

Die folgenden MSIL-Anweisungen (Microsoft Intermediate Language) lösen eine OverflowException aus:

• add.ovf. <mit Vorzeichen>

• conv.ovf. <in Typ>

• conv.ovf. <in Typ> .un

• mul.ovf. <type>

• sub.ovf. <type>

• newarr

OverflowException verwendet HRESULT COR_E_OVERFLOW mit dem Wert 0x80131516.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von OverflowException finden Sie unter OverflowException-Konstruktoren.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz

Weitere Ressourcen