OverflowException Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

OverflowException, classe

 

Exception levée quand une opération arithmétique, de transtypage ou de conversion engendre un dépassement de capacité dans un contexte vérifié (checked).

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

System.Object
  System.Exception
    System.SystemException
      System.ArithmeticException
        System.OverflowException

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class OverflowException : ArithmeticException

NomDescription
System_CAPS_pubmethodOverflowException()

Initialise une nouvelle instance de la classe OverflowException.

System_CAPS_protmethodOverflowException(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe OverflowException avec des données sérialisées.

System_CAPS_pubmethodOverflowException(String)

Initialise une nouvelle instance de la classe OverflowException avec un message d'erreur spécifié.

System_CAPS_pubmethodOverflowException(String, Exception)

Initialise une nouvelle instance de la classe OverflowException avec un message d'erreur spécifié et une référence à l'exception interne ayant provoqué cette exception.

NomDescription
System_CAPS_pubpropertyData

Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l'utilisateur sur l'exception.(Hérité de Exception.)

System_CAPS_pubpropertyHelpLink

Obtient ou définit un lien vers le fichier d'aide associé à cette exception.(Hérité de Exception.)

System_CAPS_pubpropertyHResult

Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique.(Hérité de Exception.)

System_CAPS_pubpropertyInnerException

Obtient l'instance Exception qui a provoqué l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertyMessage

Obtient un message qui décrit l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertySource

Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur.(Hérité de Exception.)

System_CAPS_pubpropertyStackTrace

Obtient une représentation sous forme de chaîne des objets immédiats sur la pile des appels. (Hérité de Exception.)

System_CAPS_pubpropertyTargetSite

Obtient la méthode qui lève l'exception actuelle.(Hérité de Exception.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetBaseException()

En cas de substitution dans une classe dérivée, retourne la Exception qui est à l'origine d'une ou de plusieurs exceptions ultérieures.(Hérité de Exception.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

En cas de substitution dans une classe dérivée, définit SerializationInfo avec des informations sur l'exception.(Hérité de Exception.)

System_CAPS_pubmethodGetType()

Obtient le type au moment de l'exécution de l'instance actuelle.(Hérité de Exception.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Crée et retourne une chaîne représentant l'exception actuelle.(Hérité de Exception.)

NomDescription
System_CAPS_proteventSerializeObjectState

Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception.(Hérité de Exception.)

Un OverflowException est levée au moment de l'exécution dans les conditions suivantes :

  • Une opération arithmétique produit un résultat qui est en dehors de la plage du type de données retourné par l'opération. L'exemple suivant illustre la OverflowException qui est levée par une opération de multiplication qui dépasse les limites de la Int32 type.

    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.
    
  • Une opération de conversion tente d'effectuer une conversion restrictive, et la valeur du type de données source est en dehors de la plage du type de données cible. L'exemple suivant illustre la OverflowException qui est levée par la tentative de convertir une valeur d'octet non signé volumineux en une valeur d'octet signée.

    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.
    

Dans chaque cas, le résultat de l'opération est une valeur qui est inférieure à la MinValue propriété supérieur ou le MaxValue propriété du type de données qui résulte de l'opération.

L'opération arithmétique, de casting ou de conversion lève une OverflowException, l'opération doit se produire dans un contexte vérifié. Par défaut, les opérations arithmétiques et les dépassements de capacité en Visual Basic sont vérifiés ; en c#, ils ne sont pas. Si l'opération se produit dans un contexte non vérifié, le résultat est tronqué en supprimant tous les bits de poids fort qui ne tiennent pas dans le type de destination. L'exemple suivant illustre ce type d'une conversion non contrôlée en c#. Il répète l'exemple précédent dans un contexte non vérifié.

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.

Les logiciels Microsoft instructions intermediate language (MSIL) lèvent une OverflowException:

  • add.ovf.< signature >

  • conv.ovf.< de type >

  • conv.ovf.< de type >.un

  • mul.ovf.<type>

  • sub.ovf.<type>

  • newarr

OverflowException utilise le HRESULT COR_E_OVERFLOW dont la valeur est 0 x 80131516.

Pour obtenir la liste des valeurs initiales des propriétés d'une instance de OverflowException, consultez la OverflowException constructeurs.

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft