WorkflowApplication.OnUnhandledException Свойство

Определение

Пространство имен:

System.Activities

Сборка:

System.Activities.dll

Возвращает или задает функцию Func<T,TResult>, которая вызывается, когда в текущем экземпляре рабочего процесса обнаруживается необработанное исключение.

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)

Значение свойства

Func<WorkflowApplicationUnhandledExceptionEventArgs,UnhandledExceptionAction>

Делегат, который вызывается, когда в экземпляре рабочего процесса обнаруживается необработанное исключение.

Примеры

В следующем примере кода вызывается рабочий процесс, в котором создается исключение. Исключение не обрабатывается рабочим процессом, и вызывается обработчик OnUnhandledException. Чтобы получить сведения об исключении, проверяются аргументы WorkflowApplicationUnhandledExceptionEventArgs, и рабочий процесс завершается.

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

Комментарии

И OnUnhandledException, и WorkflowUnhandledExceptionBehavior определяют поведение среды выполнения, когда исключение не обработано рабочим процессом. Однако при этом для WorkflowUnhandledExceptionBehavior предусмотрен параметр, который позволяет оставить приостановленный рабочий процесс в хранилище сохраняемости, а у OnUnhandledException такого параметра нет. Причина этого заключается в том, что происходящее с приостановленным рабочим процессом зависит от узла, а WorkflowApplication — не зависит. Чтобы реализовать эту возможность с помощью WorkflowApplication, создайте пользовательский PersistenceParticipant с этим поведением.