WF4.0 自定义CodeActivity与Bookmark<第三篇>

一、自定义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结合实现会签功能的时候，非常完美。

　　详细示例请查看<第二篇>；