WorkflowApplication.OnUnhandledException Propriété

Définition

Espace de noms:

System.Activities

Assembly:

System.Activities.dll

Obtient ou définit l'objet Func<T,TResult> qui est appelé lorsque l'instance de flux de travail actuelle rencontre une exception non gérée.

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)

Valeur de propriété

Func<WorkflowApplicationUnhandledExceptionEventArgs,UnhandledExceptionAction>

Délégué appelé lorsqu'une instance de flux de travail rencontre une exception non gérée.

Exemples

L'exemple suivant appelle un workflow qui lève une exception. L'exception n'est pas prise en charge par le workflow et le gestionnaire OnUnhandledException est appelé. L'objet WorkflowApplicationUnhandledExceptionEventArgs est inspecté de façon à fournir des informations sur l'exception, et le workflow est arrêté.

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();

Remarques

OnUnhandledException et WorkflowUnhandledExceptionBehavior dictent le comportement du runtime lorsqu'une exception n'est pas gérée dans le workflow ; toutefois, WorkflowUnhandledExceptionBehavior peut laisser en suspens le workflow dans le magasin de persistance, contrairement à OnUnhandledException. La raison de cela est que ce qui arrive à un workflow suspendu est spécifique à l'hôte, contrairement à WorkflowApplication. Pour implémenter cette fonctionnalité à l'aide de WorkflowApplication, créez un PersistenceParticipant personnalisé qui a ce comportement.