Windows Workflow Beta2 HOL学习笔记(二):向工作流中传递参数
本文内容来自Microsoft Hands-on Labs for Windows Workflow Foundation Beta 2中的HOL01中的第二个练习,其中包括三个任务:
Ø 定义工作流的参数
Ø 修改Code Activity
Ø 运行修改好的工作流
1.打开上一个练习创建好的HelloWorldWorkflow项目,打开Workflow1.xoml顺序工作流文件,并转到查看代码。
2.找到如下代码,然后在其中添加两个属性。
public partial class Workflow1 : SequentialWorkflowActivity
{
private void codeActivity1_CodeHandler(object sender, EventArgs e)
{
Console.WriteLine("Hello, World!");
}
}
在方法codeActivity1_CodeHandler下面打“prop”按Tab键,即可由VS2005自动生成属性的格式代码。
然后使用Tab键在绿色的区域中进行切换,,输入好后使用回车键即可转到代码下面,完成一个属性的定义。
这里定义两个属性,FirstName和LastName。
3.因为例子需要控制台弹出一个Windows中的MessageBox消息提示框,所以添加System.Windows.Forms引用。
4.修改Code Activiity实例的代码。
private void codeActivity1_CodeHandler(object sender, EventArgs e)
{
System.Windows.Forms.MessageBox.Show("Hello world: " + firstName + " " + lastName);
}
5.在当前解决方案下添加一个Windows Application项目,名字为WinFormTestHost。在菜单中选择File | Add | New Project。
6.删除其中的Form1.cs和Program.cs两个文件。
7.在我们安装HOL的如下路径找到以下四个文件,使用添加现有项添加到WinFormTestHost项目中。
C:\Windows Workflow Foundation\Labs\Lab01\Resources\WinFormTestHost Files
8.将WinFormTestHost项目设置为启动项目。
9.查看Form1.cs其中的代码如下:
public partial class Form1 : Form
{
private WorkflowRuntime wr;
private string workflowAssembly = "";
private string workflowTypeName = "";
public Form1()
{
InitializeComponent();
workflowAssembly = "HelloWorldWorkflow";
workflowTypeName = "HelloWorldWorkflow.Workflow1";
}
private void btnStartWorkflow_Click(object sender, EventArgs e)
{
if (wr == null)
{
wr = new WorkflowRuntime();
wr.StartRuntime();
}
Dictionary<string, object> parameters = new Dictionary<string, object>();
parameters.Add("FirstName", txtFirstName.Text);
parameters.Add("LastName", txtLastName.Text);
WorkflowInstance instance = wr.CreateWorkflow(typeof(HelloWorldWorkflow.Workflow1), parameters);
instance.Start();
}
private void Form1_FormClosed(object sender, FormClosedEventArgs e)
{
if (wr != null)
{
if (wr.IsStarted)
{
wr.StopRuntime();
}
}
}
}
(1)运行工作流需要工作流运行时的支持,所以首先定义并实例化了一个WorkflowRuntime对象。然后使用这个对象的StartRuntime方法启动运行时。
(2)定义了Dictionary<string, object>对象用来传递参数的数组。两个参数FirstName和LastName。界面如下:
(3)在往下就是创建工作流实例并执行工作流对象的代码了。
WorkflowInstance instance = wr.CreateWorkflow(typeof(HelloWorldWorkflow.Workflow1), parameters);
instance.Start();
(4)最后在窗口关闭的时候停止运行时。
10.其中用到的工作流的对象和方法,所以我们要添加几个引用:
项目HelloWorldWorkflow的引用
System.Workflow.Activities.dll
System.Workflow.ComponentModel.dll
System.Workflow.Runtime.dll
三个程序集的应用。
11.按F5运行程序,会出现上面的窗口,在两个输入框中输入相应的值点击Start Workflow按钮,就会看到一个Windows消息提示框。
至此完成第二个练习。
其中涉及到两个我自己不太明白的东东,准备查查MSDN放在下面:
WorkflowRuntime.CreateWorkflow方法
现在仅知道在顺序工作流类中建立属性后,可以通过这个方法,将参数放到Dictionary类中,创建工作流实例时给属性赋值。
MSDN中的原文:
WorkflowRuntime.CreateWorkflow Method (Type, Generic Dictionary)
Creates a workflow instance by using the specified workflow Type and the arguments to the workflow contained in the specified Dictionary.
Namespace: System.Workflow.Runtime
Assembly: System.Workflow.Runtime (in system.workflow.runtime.dll)
public WorkflowInstance CreateWorkflow (
Type workflowType,
Dictionary<string,Object> namedArgumentValues
)
Parameters
workflowType
The Type of the workflow to create.
namedArgumentValues
A Dictionary of objects keyed by string that represents the arguments to the workflow.
Return Value
A WorkflowInstance object that represents the workflow instance created.
Exceptions
Exception type |
Condition |
ArgumentNullException |
workflowType is a null reference (Nothing in Visual Basic). |
参考资料:
Microsoft Hands-on Labs for Windows Workflow Foundation Beta 2
WorkflowRuntime.CreateWorkflow Method (Type, Generic Dictionary)