WorkflowApplication.OnUnhandledException Propiedad

Definición

Espacio de nombres:

System.Activities

Ensamblado:

System.Activities.dll

Obtiene o establece el objeto Func<T,TResult> que se invoca cuando la instancia de flujo de trabajo actual encuentra una excepción no controlada.

public:
 property Func<System::Activities::WorkflowApplicationUnhandledExceptionEventArgs ^, System::Activities::UnhandledExceptionAction> ^ OnUnhandledException { Func<System::Activities::WorkflowApplicationUnhandledExceptionEventArgs ^, System::Activities::UnhandledExceptionAction> ^ get(); void set(Func<System::Activities::WorkflowApplicationUnhandledExceptionEventArgs ^, System::Activities::UnhandledExceptionAction> ^ value); };

public Func<System.Activities.WorkflowApplicationUnhandledExceptionEventArgs,System.Activities.UnhandledExceptionAction> OnUnhandledException { get; set; }

member this.OnUnhandledException : Func<System.Activities.WorkflowApplicationUnhandledExceptionEventArgs, System.Activities.UnhandledExceptionAction> with get, set

Public Property OnUnhandledException As Func(Of WorkflowApplicationUnhandledExceptionEventArgs, UnhandledExceptionAction)

Valor de propiedad

Func<WorkflowApplicationUnhandledExceptionEventArgs,UnhandledExceptionAction>

Delegado que se invoca cuando una instancia de flujo de trabajo encuentra una excepción no controlada.

Ejemplos

En el ejemplo siguiente se invoca un flujo de trabajo que produce una excepción. El flujo de trabajo no controla la excepción y se invoca el controlador de la propiedad OnUnhandledException. El objeto WorkflowApplicationUnhandledExceptionEventArgs se inspecciona para proporcionar información acerca de la excepción y se termina el flujo de trabajo.

Activity wf = new Sequence
{
    Activities =
     {
         new WriteLine
         {
             Text = "Starting the workflow."
         },
         new Throw
        {
            Exception = new InArgument<Exception>((env) =>
                new ApplicationException("Something unexpected happened."))
        },
        new WriteLine
         {
             Text = "Ending the workflow."
         }
     }
};

WorkflowApplication wfApp = new WorkflowApplication(wf);

wfApp.OnUnhandledException = delegate(WorkflowApplicationUnhandledExceptionEventArgs e)
{
    // Display the unhandled exception.
    Console.WriteLine("OnUnhandledException in Workflow {0}\n{1}",
        e.InstanceId, e.UnhandledException.Message);

    Console.WriteLine("ExceptionSource: {0} - {1}",
        e.ExceptionSource.DisplayName, e.ExceptionSourceInstanceId);

    // Instruct the runtime to terminate the workflow.
    return UnhandledExceptionAction.Terminate;

    // Other choices are UnhandledExceptionAction.Abort and
    // UnhandledExceptionAction.Cancel
};

wfApp.Run();

Comentarios

Tanto OnUnhandledException como WorkflowUnhandledExceptionBehavior dictan el comportamiento del runtime cuando no se controla una excepción en el flujo de trabajo; no obstante, WorkflowUnhandledExceptionBehavior tiene la opción de dejar un flujo de trabajo suspendido en el almacén de persistencia, mientras que OnUnhandledException carece de ella. Esto se debe a que lo que le sucede a un flujo de trabajo es específico del host y WorkflowApplication no lo es. Para implementar esta funcionalidad usando WorkflowApplication, cree un objeto PersistenceParticipant personalizado que tenga este comportamiento.