WF中顺序工作流本地通讯事件触发及调用步骤

Windows Workflow Foundation (WF)中顺序工作流是非常常用的一种工作流，而在工作流运行过程中通常会和宿主程序之间交换数据，用于从外部环境获取数据，同时将工作流的状态告诉外部环境。

工作流中用来达到此目的的activity有：WebServiceInput、WebServiceOutput、InvokeWebService、CallExternalMethod、HandleExternalEvent。前三个用于和WebServices交换数据，后两个用于本地的通讯。CallExternalMethod activity允许工作流来调用宿主中注册的程序，而HandleExternalEvent activity是让工作流通过宿主来监听对应的事件。 

使用CallExternalMethod、HandleExternalEvent一般需要根据以下步骤：（以下借用《Programming Windows Workflow Foundation》中代码） 

1、定义接口事件和相关的参数类型。 

用ExternalDataExchange标签定义接口和事件。用Serializable标签定义参数类型。 

    [ExternalDataExchange]

    public interface IBugFlowService

    {

        event EventHandler<BugAddedArgs> BugAdded;

        void AssignBug(Bug bug);

    }    [Serializable]

    public class BugAddedArgs : ExternalDataEventArgs

    {

        private Bug _bug;

        public BugAddedArgs(Guid instanceId, Bug newBug):base(instanceId)

        {

            _bug = newBug;

        }

        public Bug NewBug

        {

            get

            {

                return _bug;

            }

            set

            {

                _bug = value;

            }

        }

    }

2、定义传送的对象

这一步也可以放在之前或其他文件中，但对象必须打上Serializable标签。 

    [Serializable]

    public class Bug

    {

        private string _description;

        private int _id;

        private string _title;

        public Bug(int id, string title, string description)

        {

            _id=id;

            _title = title;

            _description = description;

        }

        public string Descrition

        {

            get { return _description; }

            set { _description = value;}

        }

        public int ID

        {

            get { return _id; }

            set { _id = value;}

        }

        public string Title

        {

            get {  return _title;}

            set{_title = value;}

        }

    }3、实现约定的接口

实现第一步中约定的服务接口 

    public class BugFlowService : IBugFlowService

    {

        public event EventHandler<BugAddedArgs> BugAdded;

        public void AssignBug(Bug bug)

        {

            Console.WriteLine("Assign '{0}' to developer", bug.Title);

        }

        public void CreateBug(Guid instanceID, Bug bug)

        {

            BugAddedArgs arg = new BugAddedArgs(instanceID, bug);

            EventHandler<BugAddedArgs> ev = this.BugAdded;

            if (ev != null)

            {

                ev(null, arg);

            }

        }

    }

4、设计工作流及参数

新建一个顺序工作流，并依次从ToolsBox中拖放HandleExternalEvent activity、CallExternalMethod activity。分别命名NewBug、AssignBug。

设置命名为NewBug的HandleExternalEvent activity的InterfaceType属性为IBugFlowService，指定EventName属性为BugAdded，设置e参数来代表传入的事件参数，点击右侧的省略号按钮来绑定(或创建并绑定)参数到公开域或属性(例如：_newBug)。

设置命名为AssignBug的CallExternalMethod activity的InterfaceType属性为IBugFlowService，指定MethodName属性为AssignBug，AssignBug需要一个参数bug，点击bug参数右侧的省略号按钮来绑定(或创建并绑定)参数到公开域或属性(例如：_bugToAssign)，为MethodInvoking事件生成事件处理方法AssignBug_MethodInvoking。 

        public Bug _bugToAssign;

        public BugAddedArgs _newBug;

        private void AssignBug_MethodInvoking(object sender, EventArgs e)

        {

            _bugToAssign = _newBug.NewBug;

        }5、在宿主中执行工作流

修改宿主启动工作流地方相关代码： 

    ExternalDataExchangeService dataService;

    dataService = new ExternalDataExchangeService();

    workflowRuntime.AddService(dataService);

    BugFlowService bugFlow = new BugFlowService();

    dataService.AddService(bugFlow);

    WorkflowInstance instance = workflowRuntime.CreateWorkflow(                                   typeof(wf_test1.chapter3_sequential));

    instance.Start();

    Bug bug = new Bug(1, "Bug Title", "Bug Description");

    bugFlow.CreateBug(instance.InstanceId, bug);  

注意事项说明：

1、接口必须打上ExternalDataExchange标签，才能使用工作流的数据交换服务[DataExchangeService]。

2、事件中参数类型必须继承自ExternalDataEventArgs类，参数类型必须打上Serializable标签。

3、事件句柄建议使用EventHandler<T>的方式，否则可能收到“The event BugAdded has to be of type EventHandler where T derives from ExternalDataEventArgs”的错误提示。

4、需要引用System.Workflow.Activities命名空间。

本文来源于Dominic.Xu’s 博客 http://web2world.cn , 原文地址： http://web2world.cn/article/2008/01/a81.html