This documentation is archived and is not being maintained.

WorkflowRuntime::ServicesExceptionNotHandled Event

Occurs when a service that is derived from the WorkflowRuntimeService class calls RaiseServicesExceptionNotHandledEvent.

Namespace:  System.Workflow.Runtime
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)

public:
 event EventHandler<ServicesExceptionNotHandledEventArgs^>^ ServicesExceptionNotHandled {
	void add (EventHandler<ServicesExceptionNotHandledEventArgs^>^ value);
	void remove (EventHandler<ServicesExceptionNotHandledEventArgs^>^ value);
}

A service that is derived from the WorkflowRuntimeService class can call the RaiseServicesExceptionNotHandledEvent method to inform subscribers to the ServicesExceptionNotHandled event that an exception that it was unable to handle occurred during its execution. You can subscribe to this event to implement a recovery mechanism.

This event is raised when a workflow instance has not been created yet by the workflow run-time engine and an exception occurs. In this scenario, the only way to inform a host application that an exception occurred is to raise this event. However, the workflow run-time engine does not call this directly. Instead, the workflow run-time engine either delivers an exception to the workflow instance or, if there is no instance, throws back to the caller, which in this case is actually the service that fires this event. If you create your own persistence or scheduler service, you must implement this event yourself through the base RaiseServicesExceptionNotHandledEvent method.

For the ServicesExceptionNotHandled event, the sender contains the WorkflowRuntime and WorkflowEventArgs contains the Guid of the workflow instance that was using the service and the Exception that could not be handled.

For more information about handling events, see Consuming Events.

The following code example demonstrates how to use WorkflowRuntime functionality from a workflow host. The code associates ServicesExceptionNotHandled with an event handler, a method named OnExceptionNotHandled.

This code example is part of the Custom Persistence Service Sample.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: