WF4.0 基础篇 (十二) CancellationScope 取消容器

本节主要介绍CancellationScope在异常中的使用,以及CancellationScope在Parallel 的使用.

 

本文例子下载:

https://files.cnblogs.com/foundation/CancellationScopeSample.rar

本文例子说明

 

CancellationScope 取消容器

类名	System.Activities.Statements.CancellationScope
文件	System.Activities.dll
结构说明	继承 NativeActivity 是一个 sealed类 override 了 [CacheMetadata方法] 与 [Execute方法] 与[Cancel 方法] [Body]属性的类型为[Activity] [CancellationHandler] 属性 的类型为[Activity] [Variables] 属性 的类型为[Collection<Variable>]
功能说明	[CancellationScope]中可以定义变量 [CancellationScope]由[Body]与 [CancelHandler] 两部分组成,[Body]为正常执行路径, 如果取消执行会调用 [CancelHandler]中的内容

 

 

实例使用[OnUnhandledException.Cancel]处理异常

实例使用[OnUnhandledException.Cancel]处理异常时,[CancelHandler] 部分会被调用

 

ExceptionActivity	public sealed class ExceptionActivity : CodeActivity { protected override void Execute(CodeActivityContext context) { int v = 1 -1; double i = 1 / v; } }
流程
宿主	//============================================================== static void workflowCompleted(WorkflowApplicationCompletedEventArgs e) { System.Console.WriteLine("完成,实例编号:{0},状态:{1}", e.InstanceId, e.CompletionState.ToString()); }   static void aborted(WorkflowApplicationAbortedEventArgs e) { System.Console.WriteLine("aborted ,实例编号:{1},Reason:{0}", e.Reason.Message, e.InstanceId); } //==============================================================   #region //CancellationWorkflow 例子 static void exceptionActivityWorkflow() { WorkflowApplication instance = new WorkflowApplication(new CancellationWorkflow());   instance.Completed = new Action<WorkflowApplicationCompletedEventArgs>(workflowCompleted); instance.OnUnhandledException = unhandledException_Cancel; instance.Aborted = aborted;   instance.Run(); }   static UnhandledExceptionAction unhandledException_Cancel(WorkflowApplicationUnhandledExceptionEventArgs e) { System.Console.WriteLine("unhandledException_Cancel:{0}", e.UnhandledException.Message); return UnhandledExceptionAction.Cancel; } #endregion
结果	1.如果异常出现在[CancellationScope 取消容器]中,当[UnhandledExceptionAction]方法的返回值为[Cancel]时,会调用[CancellationScope]的[CancelHandler]部分 2.完成[CancelHandler]部分后,流程结束.会调用实例的[OnCompleted ]

 

Parallel中使用 CancellationScope

在WF4中,可以使用[Parallel] 并行执行多条分支,当[Parallel]中的所有分支都执行完成后,[Parallel]结束.

可以使用[Pick]实现多条等待分支的单线执行,当一条分支被触发后,其它分支就不会被触发了,当触发的分支完成后,[Pick]结束

但有时我们会的这样一种需求,我们需要并行执行多条分支,当并行分支中的一条或几条分支满足指定条件时,其它正在执行的分支就不执了.同时,为了保证数据的完整性,我们需要在那些可能要取消的分支中余留一组代码.这组代码用于在该分支被取消后做一些收尾工做

可以在[Parallel]容器中使用[CancellationScope],当[Parallel]的[CompletionCondition]属性为[True]时,[Parallel]容器会在其内部[CancellationScope]容器执行完成后,结束其它正在执行的并行分支.如果其它正在执行的并行分支是[CancellationScope],则会调用该[CancellationScope]的[CancelHandler]

 

例子:

1.在流程中添加bool 型变量[myVariable],默认值False

2.添加[Parallel],并添加二个CancellationScope分支

第一个分支:

[Body]部分:添加[Delay]延时 15秒;添加[WriteLine]打印当"A" 添加[Assign]为变量[myVariable]赋值True

[CancelHandler]部分:添加[WriteLine]打印当"Cancellation:A取消"

第二个分支:

添加[Delay]延时 10秒;添加[WriteLine]打印当"B" ; 添加[Assign]为变量[myVariable]赋值True

[CancelHandler]部分:添加[WriteLine]打印当"Cancellation:B取消"

3. 将[Parallel.CompletionCondition ] 绑定到变量[myVariable]

 

流程
宿主	//============================================================== static void workflowCompleted(WorkflowApplicationCompletedEventArgs e) { System.Console.WriteLine("完成,实例编号:{0},状态:{1}", e.InstanceId, e.CompletionState.ToString()); }   static void aborted(WorkflowApplicationAbortedEventArgs e) { System.Console.WriteLine("aborted ,实例编号:{1},Reason:{0}", e.Reason.Message, e.InstanceId); }   static UnhandledExceptionAction unhandledException_Cancel(WorkflowApplicationUnhandledExceptionEventArgs e) { System.Console.WriteLine("unhandledException_Cancel:{0}", e.UnhandledException.Message); return UnhandledExceptionAction.Cancel; }   //==============================================================     #region //ParallelCancellationWorkflow 例子   static void parallelCancellationWorkflow() { WorkflowApplication instance = new WorkflowApplication(new ParallelCancellationWorkflow());   instance.Completed = new Action<WorkflowApplicationCompletedEventArgs>(workflowCompleted); instance.OnUnhandledException = unhandledException_Cancel; instance.Aborted = aborted;   instance.Run(); } #endregion
结果