OverflowException Класс

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

OverflowException.cs

Исключение, которое возникает, когда арифметическое, приведение или операция преобразования в проверяемом контексте приводит к переполнению.

public ref class OverflowException : ArithmeticException

public class OverflowException : ArithmeticException

type OverflowException = class
    inherit ArithmeticException

Public Class OverflowException
Inherits ArithmeticException

Наследование

Object

Exception

SystemException

ArithmeticException

OverflowException

Комментарии

OverflowException создается во время выполнения в следующих условиях:

• Арифметическая операция создает результат, который выходит за пределы диапазона типа данных, возвращаемого операцией. В следующем примере показана OverflowException, которая создается операцией умножения, которая переполнена границами типа 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.
  

• Операция приведения или преобразования пытается выполнить сужение преобразования, а значение исходного типа данных выходит за пределы диапазона целевого типа данных. В следующем примере показана OverflowException, вызываемая попыткой преобразовать большое значение без знака в значение со знаком байтов.

  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.
  

В каждом случае результатом операции является значение, которое меньше свойства MinValue или больше свойства MaxValue типа данных, которое приводит к операции.

Для арифметического, приведения или преобразования операции создания OverflowExceptionоперация должна выполняться в проверяемом контексте. По умолчанию проверяются арифметические операции и переполнения в Visual Basic; В C# и F#они не являются. Если операция возникает в незавершенном контексте, результат усечен путем отмены любых битов высокого порядка, которые не соответствуют типу назначения. В следующем примере показана такая отмена преобразования в C# или F#. Он повторяет предыдущий пример в незаверяемом контексте.

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.

Следующие инструкции microsoft промежуточного языка (MSIL) вызывают OverflowException:

• add.ovf. <подписанный>

• conv.ovf. <для ввода>

• conv.ovf. <для ввода>.un

• типа

• типа

• newarr

OverflowException использует COR_E_OVERFLOW HRESULT, который имеет значение 0x80131516.

Список начальных значений свойств для экземпляра OverflowExceptionсм. в конструкторах OverflowException.

Конструкторы

OverflowException()	Инициализирует новый экземпляр класса OverflowException.
OverflowException(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр класса OverflowException с сериализованными данными.
OverflowException(String)	Инициализирует новый экземпляр класса OverflowException с указанным сообщением об ошибке.
OverflowException(String, Exception)	Инициализирует новый экземпляр класса OverflowException с указанным сообщением об ошибке и ссылкой на внутреннее исключение, которое является причиной этого исключения.

Свойства

Data	Возвращает коллекцию пар "ключ-значение", которые предоставляют дополнительные пользовательские сведения об исключении. (Унаследовано от Exception)
HelpLink	Возвращает или задает ссылку на файл справки, связанный с этим исключением. (Унаследовано от Exception)
HResult	Возвращает или задает HRESULT, закодированное числовое значение, назначенное определенному исключению. (Унаследовано от Exception)
InnerException	Возвращает экземпляр Exception, вызвавшего текущее исключение. (Унаследовано от Exception)
Message	Возвращает сообщение, описывающее текущее исключение. (Унаследовано от Exception)
Source	Возвращает или задает имя приложения или объекта, вызывающего ошибку. (Унаследовано от Exception)
StackTrace	Возвращает строковое представление непосредственных кадров в стеке вызовов. (Унаследовано от Exception)
TargetSite	Возвращает метод, который вызывает текущее исключение. (Унаследовано от Exception)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBaseException()	При переопределении в производном классе возвращает Exception, которая является основной причиной одного или нескольких последующих исключений. (Унаследовано от Exception)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)	Устаревшие.. При переопределении в производном классе задает SerializationInfo с информацией об исключении. (Унаследовано от Exception)
GetType()	Возвращает тип среды выполнения текущего экземпляра. (Унаследовано от Exception)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

Устаревшие.. Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)

См. также раздел

• Exception
• обработке и вызове исключений