Throwable.AddSuppressed(Throwable) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute l’exception spécifiée aux exceptions qui ont été supprimées pour remettre cette exception.
[Android.Runtime.Register("addSuppressed", "(Ljava/lang/Throwable;)V", "")]
public void AddSuppressed (Java.Lang.Throwable exception);[<Android.Runtime.Register("addSuppressed", "(Ljava/lang/Throwable;)V", "")>]
member this.AddSuppressed : Java.Lang.Throwable -> unitParamètres
- exception
- Throwable
exception à ajouter à la liste des exceptions supprimées
- Attributs
Exceptions
si throwable == this.
si throwable == null.
Remarques
Ajoute l’exception spécifiée aux exceptions qui ont été supprimées pour remettre cette exception. Cette méthode est thread-safe et généralement appelée (automatiquement et implicitement) par l’instruction try-with-resources.
Le comportement de suppression est activé <em>sauf si</em> désactivé #Throwable(String, Throwable, boolean, boolean) via un constructeur. Lorsque la suppression est désactivée, cette méthode ne fait rien d’autre que de valider son argument.
Notez que lorsqu’une exception #initCause(Levée) provoque une autre exception, la première exception est généralement interceptée, puis la deuxième exception est levée en réponse. En d’autres termes, il existe une connexion causale entre les deux exceptions.
En revanche, il existe des situations où deux exceptions indépendantes peuvent être levées dans des blocs de code frères, en particulier dans le try bloc d’une tryinstruction -with-resources et le bloc généré par finally le compilateur qui ferme la ressource.
Dans ces situations, une seule des exceptions levées peut être propagée. Dans l’instruction try-with-resources, lorsqu’il existe deux exceptions de ce type, l’exception provenant du try bloc est propagée et l’exception du finally bloc est ajoutée à la liste des exceptions supprimées par l’exception du try bloc. En tant qu’exception dérouillée la pile, elle peut accumuler plusieurs exceptions supprimées.
Une exception peut avoir supprimé des exceptions tout en étant également provoquée par une autre exception. Si une exception a ou non une cause est connue sémantiquement au moment de sa création, contrairement à la suppression ou non d’une exception qui est généralement déterminée uniquement après la levée d’une exception.
Notez que le code écrit par programmeur peut également tirer parti de l’appel de cette méthode dans des situations où il existe plusieurs exceptions frères et qu’une seule peut être propagée.
Ajouté dans la version 1.7.
Documentation Java pour java.lang.Throwable.addSuppressed(java.lang.Throwable).
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.