When Android calls into managed code and the managed code throws an Exception, the exception needs to be caught at the Android/managed boundary and handled appropriately. For example, the exception could be ignored entirely, or the exception could be translated into a Java.Lang.Throwable instance and raised within Android by using AndroidEnvironment.RaiseThrowable(Java.Lang.Throwable).

If an event handler chooses to handle this event, it should set the RaiseThrowableEventArgs.Handled property to true.

Operation

The UnhandledExceptionRaiser event is raised when an unhandled exception is caught at the Android/managed boundary. All registered event handlers will be invoked in order of registration until one of them sets RaiseThrowableEventArgs.Handled to true. If there are no registered handlers or none of them set RaiseThrowableEventArgs.Handled to true, then Java.Lang.Throwable.FromException(Exception) is used to translate the exception instance into a closest-matching Java.Lang.Throwable instance, and then AndroidEnvironment.RaiseThrowable(Java.Lang.Throwable) is invoked.

Usage

Subscribers to the UnhandledExceptionRaiser event must ensure that AndroidEnvironment.RaiseThrowable(Java.Lang.Throwable) is not invoked more than once as part of a managed-to-Android transition, and should thus set RaiseThrowableEventArgs.Handled to true if they do so.

Namespace: Android.Runtime
Assembly: Mono.Android (in Mono.Android.dll)
Assembly Versions: 0.0.0.0