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を作成します。

適用対象