OverflowException Класс

Ссылка

Определение

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

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class OverflowException : ArithmeticException

public class OverflowException : ArithmeticException

[System.Serializable]
public class OverflowException : ArithmeticException

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

type OverflowException = class
    inherit ArithmeticException

[<System.Serializable>]
type OverflowException = class
    inherit ArithmeticException

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

Public Class OverflowException
Inherits ArithmeticException

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

Exception

ArithmeticException
OverflowException

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

Exception

SystemException

ArithmeticException
OverflowException

Атрибуты: SerializableAttribute ComVisibleAttribute

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

Следующие инструкции msIL создают исключение OverflowException:

add.ovf. <signed>
conv.ovf. <to type>
conv.ovf. <to type> .un
mul.ovf. <type>
sub.ovf. <type>
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)

Применяется к