Dispatcher::UnhandledExceptionFilter Event

 

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.

Namespace:   System.Windows.Threading
Assembly:  WindowsBase (in WindowsBase.dll)

public:
event DispatcherUnhandledExceptionFilterEventHandler^ UnhandledExceptionFilter {
	void add(DispatcherUnhandledExceptionFilterEventHandler^ value);
	void remove(DispatcherUnhandledExceptionFilterEventHandler^ value);
}

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.

UIPermission

for adding or removing a handler for this event. Associated enumerations: PermissionState::Unrestricted

.NET Framework
Available since 3.0
Return to top
Show: