Dispatcher.UnhandledExceptionFilter Event

Definition

Occurs when a thread exception is thrown and uncaught during execution of a delegate by way of Invoke or BeginInvoke when in the filter stage.

C#
[add: System.Security.SecurityCritical]
[remove: System.Security.SecurityCritical]
public event System.Windows.Threading.DispatcherUnhandledExceptionFilterEventHandler UnhandledExceptionFilter;
C#
public event System.Windows.Threading.DispatcherUnhandledExceptionFilterEventHandler UnhandledExceptionFilter;

Event Type

Attributes

Remarks

This event is raised during the filter stage for an exception that is raised during execution of a delegate by way of Invoke or BeginInvoke and is uncaught.

The call stack is not unwound at this point (first-chance exception).

Event handlers for this event must be written with care to avoid creating secondary exceptions and to catch any that occur. It is recommended to avoid allocating memory or doing any resource intensive operations in the handler.

The UnhandledExceptionFilter event provides a means to not raise the UnhandledException event. The UnhandledExceptionFilter event is raised first, and If RequestCatch on the DispatcherUnhandledExceptionFilterEventArgs is set to false, the UnhandledException event will not be raised.

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also