一、自定义CodeActivity
CodeActivity用于自定义一段代码,可实现你自己写的任意功能。
要注意的有两点:
1、自定义CodeActivity必须继承自CodeActivity;
2、Execute是你想要执行的代码,CodeActivityContext对象参数与原有工作流进行交互。
CodeActivityContext从ActivityContext继承了如下2个常用方法:
方法/属性 | 说明 |
ActivityInstanceId | 获取当前正在执行的活动实例的唯一标识符。 |
WorkflowInstanceId | 获取当前正在执行的工作流实例的唯一标识符 |
GetValue() | 获取指定的 Argument 的值 |
SetValue() | 为指定的 Argument 赋值 |
右键工作流项目=》新建项=>活动,可以添加一个CodeActivity。
其代码如下:
public sealed class CodeActivity1 : CodeActivity { //调用此自定义活动必须用一个变量接收返值 public OutArgument<string> Result { get; set; } protected override void Execute(CodeActivityContext context) {string input = Console.ReadLine(); //为外部工作流赋值 context.SetValue(Result, input); } }
代码逻辑为,将读取到的内容为外部变量赋值。
当完成添加之后,在左侧菜单就能够看到该控件。
工作流如下:
需要定义一个变量variable1,并用此设置自定义Code活动的Result属性;
执行效果如下:
二、Bookmark
Bookmark与CodeActivity的区别
- 当工作流运行至Bookmark时,Bookmark会让工作流在此处挂起(Idel),是线程挂起,如果是Web请求处理程序执行,将不会返回,等待恢复。而Code不会挂起;
- Code继承自CodeActivity,而Bookmark需继承自NativeActivity;
设计一个Bookmark<T>如下:
public sealed class Bookmark1<T> : NativeActivity<T> { public InArgument<string> InParam { get; set; } protected override bool CanInduceIdle { get{ return true; } } protected override void Execute(NativeActivityContext context) { this.Result.Set(context, "结果传出"); context.CreateBookmark("Borkmark1", new BookmarkCallback(bookmarkCallback)); } //恢复运行时的回调函数 void bookmarkCallback(NativeActivityContext context, Bookmark bookmark, object obj) { MessageBox.Show("恢复运行,传入的参数是:" + obj); //接收到的参数 this.Result.Set(context, (T)obj); } }
新建一个工作流如下:
新建一个WinFrom程序如下:
其代码如下:
public partial class Form1 : Form { WorkflowApplication instance = null; public Form1() { InitializeComponent(); } private void button1_Click(object sender, EventArgs e) { instance = new WorkflowApplication(new WorkflowConsoleApplication1.Workflow1()); instance.OnUnhandledException = unhandledExceptionl; instance.Aborted = aborted; instance.Idle = workflowIdel; instance.Completed = workflowCompleted; instance.Run(); } private void button2_Click(object sender, EventArgs e) { if (instance.GetBookmarks().Count() == 1) { BookmarkResumptionResult BRR = instance.ResumeBookmark(instance.GetBookmarks()[0].BookmarkName,"inPut"); MessageBox.Show("Bookmark恢复执行:" + BRR.ToString()); } } void workflowCompleted(WorkflowApplicationCompletedEventArgs e) { MessageBox.Show("完成!"); } void aborted(WorkflowApplicationAbortedEventArgs e) { MessageBox.Show("中止!"); } UnhandledExceptionAction unhandledExceptionl(WorkflowApplicationUnhandledExceptionEventArgs e) { MessageBox.Show("异常!"); return UnhandledExceptionAction.Cancel; } void workflowIdel(WorkflowApplicationIdleEventArgs e) { MessageBox.Show("挂起!"); } }
其执行效果为:
点击启动工作流 => 弹出"挂起" => 点击恢复运行 => 弹出"Bookmark恢复运行:Success" => 弹出"恢复运行,传入的参数是inPut" => 弹出"完成"
基本上运行一次就知道这种执行顺序了。
BookMark是一个非常重要的工具,它能够暂停工作流的执行,让工作流进入空闲状态。这在状态机工作流中是非常有用的。尤其状态机与MVC结合实现会签功能的时候,非常完美。
详细示例请查看<第二篇>;