《WF编程》系列之17 - 工作流与外部事件:工作流参数 居然有两个多月没有更新WF笔记,这段时间也许真的太忙了,毕业的事情,工作的事情,从今天起继续更新.
《WF编程》系列之17 - 工作流与外部事件:工作流参数
| 居然有两个多月没有更新WF笔记,这段时间也许真的太忙了,毕业的事情,工作的事情,从今天起继续更新. |
3.2.2 工作流参数
Runtime的CreateWorkflow方法有一个重载允许我们向新的工作流实例传递参数,参数的类型是Dictionary(名值对的集合).
parameters.Add("FirstName", "Scott");
parameters.Add("LastName", "Allen");
WorkflowInstance instance = workflowRuntime.CreateWorkflow(typeof(chapter3_parameter.Workflow1), parameters);
instance.Start();
当工作流Runtime创建了新的工作流实例时,它会尝试寻找每个参数名称的伴随属性(Companion Property).伴随属性是工作流对象中公开并可写的属性,它们有着和工作流参数项相同的名字.举例来说,工作流会接受上面代码中的FirstName和LastName参数是因为在其内部有着同样名字的属性:
public string FirstName
{
set { _firstName = value; }
}
private string _firstName;
//只写
public string LastName
{
set { _lastName = value; }
}
private string _lastName;
//只读
public string FullName
{
get { return _fullName; }
}
private string _fullName;
如果我们尝试传递一个FullName参数,Runtime会抛出异常,因为FullName属性是只读的.Runtime无法为其找到相应的公开并可写的伴随属性,Runtime会抛出System.ArgumentException异常.对于参数来说,必须有公开并可写的属性与之对应;而对属性来说,并不是每一个公开并可写的属性都必须对应一个参数,输入参数是可选的.
工作流内的活动不需要关心如何取得参数值.Runtime会在工作流执行前将所有的参数指派给相应的属性.在上面的代码中, CodeActivity的ExecuteCode事件将接收到的FirstName和LastName参数合并到FullName属性中.不仅仅可以向工作流输入数据,我们还可以将FullName属性作为工作流的输出参数.当工作流完成时,Runtime触发WorkflowCompleted事件, 该事件的WorkflowCompletedEventArgs参数包含一个OutputParameters属性(输出参数的Dictionary集合),Runtime将复制每个公开可读的工作流属性到OutputParameters集合中.
现在来测试一下,输出的结果如下图所示:
| 可以看到我们输入的两个参数(Scott和Allen)合并的结果,但是DynamicUpdateCondition是什么呢?它并不是我们的输入参数,之前提到过Runtime会把每个公开可读的工作流属性复制到OutputParameters集合中,而DynamicUpdateCondition正是SequentialWorkflowActivity的一个公开并可读的属性.但问题又出来了, SequentialWorkflowActivity有很多公开并可读的属性,为什么仅仅是DynamicUpdateCondition被作为输出参数?期待园子里的朋友可以回答我这个问题. |
