宿主和工作流：两个世界的交互 I (Host给工作流传递初始化数据)

      在CodeProject中有一篇介绍宿主程序如何和工作流进行交互，使用wf提供的两个活动就可以实现，分别是callExternalMethodActivity1和handleExternalEventActivity1活动，在后面会详细介绍。
      宿主和工作流的交互是非常常用的，因为他们是运行在不同的线程中的。

      首先介绍如何从宿主传递数据给工作流，一般都是初始化的数据，例如，工作流什么时候启动等，除了这些我们就不需要其他的交互了。
可以想象一种情况，我们想要从计算机读取一个文件，读取一定数量的字符。
我们可以想象一个这样的程序，你能传递两个参数（文件的路径和字符的数量），在工作流的内部使用MessageBox显示文件的信息。请看下图
   
      User输入参数，运行控制台程序，控制台程序运行在一个线程中，相当于前面提到的Host，工作流运行在另外一个线程中，在Host要初始化工作流并且传递刚才输入的参数，在工作流中根据参数打开文件，读取一定数量的字符内容，用弹出窗体来显示内容，User看到内容。
      在以往的学习中我们已经知道，给工作流传递参数，我们要使用Dictionary<string, object> ，
工作流类的完整代码如下

using System;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.Collections;
using System.Drawing;
using System.Linq;
using System.Workflow.ComponentModel.Compiler;
using System.Workflow.ComponentModel.Serialization;
using System.Workflow.ComponentModel;
using System.Workflow.ComponentModel.Design;
using System.Workflow.Runtime;
using System.Workflow.Activities;
using System.Workflow.Activities.Rules;

namespace com.kimbanx.sharepoint.wf
{
    public partial class Workflow1 : SequentialWorkflowActivity
    {
        string _filepath = string.Empty;
        int _quantity = 0;
        //Variable to hold the result
        string _result = string.Empty;
        /// <summary>
        /// The Property name must be the same as the object in the 
        /// input parameter dictionary
        /// </summary>
        public int Quantity
        {
            get { return _quantity; }
            set { _quantity = value; }
        }
        /// <summary>
        /// The Property name must be the same as the object in the 
        /// input parameter dictionary 
        /// </summary>
        public string FilePath
        {
            get { return _filepath; }
            set { _filepath = value; }
        }
    }
}

Host（就是我们这里的控制台程序）的代码如下

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Workflow.Runtime;
using System.Workflow.Runtime.Hosting;

namespace CallExternalMethodDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            using(WorkflowRuntime workflowRuntime = new WorkflowRuntime())
            {
                AutoResetEvent waitHandle = new AutoResetEvent(false);
                workflowRuntime.WorkflowCompleted += delegate(object sender, WorkflowCompletedEventArgs e) {waitHandle.Set();};
                workflowRuntime.WorkflowTerminated += delegate(object sender, WorkflowTerminatedEventArgs e)
                {
                    Console.WriteLine(e.Exception.Message);
                    waitHandle.Set();
                };

                Dictionary<string, object> argumentDictionary = new Dictionary<string, object>();

                //Pass the first parameter: the file path. You must use the same name that was defined as variable in the workflow.

                argumentDictionary.Add("FilePath", _filepath);

                argumentDictionary.Add("Quantity", _readQuantity);

                WorkflowInstance instance = workflowRuntime.CreateWorkflow(typeof(CallExternalMethodDemo.Workflow1),argumentDictionary);
                instance.Start();

                waitHandle.WaitOne();
            }
        }
    }
}

从Host给工作流传递数据的三个基本步骤是：
1、在工作流中创建必要属性，用来接收传递过来的数据
2、在Host程序中创建  Dictionary<string, object>的实例，用来存储初始化参数数据
3、使用CreateWorkflow的重载方法，将 Dictionary<string, object>的实例作为参数传递给工作流   
      上面的例子中我们只需要给工作流传递数据，但是什么时候工作流需要传递数据给我们的Host呢？在接下来的文章中我们将会讲到。

谢谢！