OverflowException Sınıf

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Denetlenen bir bağlamdaki bir aritmetik, atama veya dönüştürme işlemi taşmayla sonuçlandığında oluşan özel durum.

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
Devralma
Object
Exception
ArithmeticException
OverflowException
Devralma
Object
Exception
SystemException
ArithmeticException
OverflowException
Öznitelikler
SerializableAttribute ComVisibleAttribute

Açıklamalar

aşağıdaki koşullarda çalışma zamanında oluşturulur OverflowException :

  • Aritmetik bir işlem, işlem tarafından döndürülen veri türü aralığının dışında bir sonuç üretir. Aşağıdaki örnekte, türün OverflowException sınırlarını aşan bir çarpma işlemi tarafından oluşan gösterilmektedir 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.

  • Bir atama veya dönüştürme işlemi bir daraltma dönüştürmesi gerçekleştirmeye çalışır ve kaynak veri türünün değeri hedef veri türü aralığının dışındadır. Aşağıdaki örnekte OverflowException , büyük bir imzalanmamış bayt değerini imzalı bir bayt değerine dönüştürme girişimi tarafından ortaya çıkan gösterilir.

    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.

Her durumda, işlemin sonucu, özelliğinden MinValue küçük veya işlemden kaynaklanan veri türünün özelliğinden MaxValue büyük bir değerdir.

Aritmetik, atama veya dönüştürme işleminin oluşturması OverflowExceptioniçin, işlemin denetlenen bir bağlamda gerçekleşmesi gerekir. Varsayılan olarak, Visual Basic'te aritmetik işlemler ve taşmalar denetlenir; C# ve F# dilinde değildir. İşlem denetlenmeyen bir bağlamda gerçekleşirse, hedef türe sığmayan yüksek sıralı bitler atılarak sonuç kesilir. Aşağıdaki örnekte C# veya F# dilinde bu tür bir işaretlenmemiş dönüştürme gösterilmektedir. Önceki örneği işaretlenmemiş bir bağlamda yineler.

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.

Aşağıdaki ara dil (MSIL) Microsoft yönergeleri bir OverflowExceptionoluşturur:

  • add.ovf.<Imzalı>

  • conv.ovf.<yazın>

  • conv.ovf.<yazın>.un

  • mul.ovf.<Türü>

  • sub.ovf.<Türü>

  • newarr

OverflowException değeri 0x80131516 olan HRESULT COR_E_OVERFLOW kullanır.

örneğinin ilk özellik değerlerinin OverflowExceptionlistesi için oluşturuculara OverflowException bakın.

Oluşturucular

OverflowException()

OverflowException sınıfının yeni bir örneğini başlatır.
OverflowException(SerializationInfo, StreamingContext)

OverflowException sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.
OverflowException(String)

Belirtilen hata iletisiyle sınıfının yeni bir örneğini OverflowException başlatır.
OverflowException(String, Exception)

Belirtilen bir hata iletisi ve bu özel durumun nedeni olan iç özel duruma başvuru ile sınıfının yeni bir örneğini OverflowException başlatır.

Özellikler

Data

Özel durum hakkında kullanıcı tanımlı ek bilgiler sağlayan bir anahtar/değer çifti koleksiyonu alır.

(Devralındığı yer: Exception)
HelpLink

Bu özel durumla ilişkili yardım dosyasının bağlantısını alır veya ayarlar.

(Devralındığı yer: Exception)
HResult

Belirli bir özel duruma atanan kodlanmış sayısal bir değer olan HRESULT değerini alır veya ayarlar.

(Devralındığı yer: Exception)
InnerException

Geçerli özel duruma Exception neden olan örneği alır.

(Devralındığı yer: Exception)
Message

Geçerli özel durumu açıklayan bir ileti alır.

(Devralındığı yer: Exception)
Source

Hataya neden olan uygulamanın veya nesnenin adını alır veya ayarlar.

(Devralındığı yer: Exception)
StackTrace

Çağrı yığınındaki anlık çerçevelerin dize gösterimini alır.

(Devralındığı yer: Exception)
TargetSite

Geçerli özel durumu oluşturan yöntemini alır.

(Devralındığı yer: Exception)

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetBaseException()

Türetilmiş bir sınıfta geçersiz kılındığında, sonraki bir veya daha fazla özel durumun kök nedeni olan değerini döndürür Exception .

(Devralındığı yer: Exception)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

Türetilmiş bir sınıfta geçersiz kılındığında, özel durum hakkındaki bilgilerle öğesini ayarlar SerializationInfo .

(Devralındığı yer: Exception)
GetType()

Geçerli örneğin çalışma zamanı türünü alır.

(Devralındığı yer: Exception)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.

(Devralındığı yer: Exception)

Ekinlikler

SerializeObjectState
Geçersiz.

Bir özel durum, özel durum hakkında serileştirilmiş veriler içeren bir özel durum nesnesi oluşturmak üzere seri hale getirildiğinde gerçekleşir.

(Devralındığı yer: Exception)

Şunlara uygulanır

Ayrıca bkz.