一、基元工具
1、Delay
Delay用于延迟一段时间执行下面的流程。在WF中实例是单线程运行的,Delay并不是Thread.Sleep方法实现的。
Delay有一个Duration属性,用于设置间隔多长时间后继续往下执行。
工作流如下:
输出如下:
2、Assign
Assign主要用于为变量赋值。对于允许创建变量的活动,右键=>创建变量,就能够添加一个变量。
新建一个工作流如下:
首先定义一个变量"i",其默认值为0,通过Assign设置其默认值。
以上程序输出"1"。
3、InvokedMethod
InvokedMethod用于调用一个方法。
如对于里面的一个字符串变量要调用一个Replace()的示例如下:
各个属性说明如下:
属性 | 说明 |
TargetType | 要调用的方法的类名(静态方法会用到) |
TargetObject | 要调用方法的实例(没有就new啊) |
MethotName | 要调用的方法名 |
Parameters | 要传到方法的参数(有输入、输出、输出/输出分别对应C#的正常传入、out关键字、ref关键字) |
Result | 得到的结果赋值到哪里 |
GenericTypeArguments | 如果是泛型,则用GenericTypeArguments参数传递泛型类型 |
RunAsynchronously | 是否异步调用 |
4、InvokedMethod
http://msdn.microsoft.com/zh-cn/library/hh305737.aspx
二、事务
1、WriteLine
WriteLine用于往控制台输出一段字符串。WriteLine有两个属性"Text"与"TextWriter"。
- Text:接收一段字符串,然后用TextWriter输出!
- TextWriter:接收一个TextWriter对象,用TextWriter输出Text的内容!
分别设置其属性如下:
代码如下:
namespace WorkflowConsoleApplication1 { class Program { static void Main(string[] args) { Activity workflow1 = new Workflow1(); WorkflowInvoker.Invoke(workflow1); Console.ReadKey(); } } //用自定义TestWriter输出Text里的内容 public class CustomTextWriter : TextWriter { public override Encoding Encoding { get { return Encoding.UTF8; } } public override void WriteLine(string value) { Console.WriteLine("自定义TextWriter输出:" + value); } } }
显示如下:
三、集合
集合中有4个活动,都是用于对集合进行各种操作。
- AddToCollection<T> 添加一个项到指定集合中;
- ClearCollection<T> 清除指定集合的所有项;
- ExistsInCollection<T> 判断一个指定项是否存在集合中;
- RemoveFromCollection<T> 从集合中移除一个元素;
它们的属性大都相似,如下表格所示:
属性 | 说明 |
Collection | 集合的对象名 |
Item | 元素值 |
TypeArgument | 集合的泛型类型,即List<T>中的T |
Result | 结果存放到哪个变量 |
示例都懒得贴上来了,使用方法很简单。唯一要注意的一点是这些控件是对现有集合对象进行操作。因此,首先要定义一个集合变量如:
四、控制流工具
1、IF
If用于根据条件判断流程做选择的分支。它有一个Condition属性,用于接收一个bool类型的参数。如果Condition为true,则执行Then。如果Condition为false,则执行Else。
当然,还能够在If里增加一个变量,让流程根据变量得到Condition结果,执行。
一个最简单的If示例如下:
2、Switch<T>
根据条件,执行不同的分支,与C#的Switch意义相同。只不过Case、Default后面跟着的不是代码,而是Activity!
3、While
While有一个Condition条件,通常会配合变量来使用。Body为循环的活动主体。下面实现一个逻辑如下:
while(i<10) { Console.WriteLine("还小于10!"); i++; }
对应的流程图如下:
需定义一个变量i。运行结果与上面代码一样。
4、DoWhile
DoWhile中可以定义变量,与C#语法中的dowhile一致。无论条件如何,至少执行一次。
下面给出一个逻辑如下的示例:
static void Main(string[] args) { int i = 0; do { Console.WriteLine("还小于10!"); i++; } while (i < 10); Console.ReadKey(); }
如下:
5、ForEach<T>
Foreach<T>与C#语法里的foreach同义。
下面的流程实现的逻辑如下:
static void Main(string[] args) { int[] IntArr = new int[5] { 1, 2, 3, 4, 5 }; foreach (int item in IntArr) { Console.WriteLine(item); } Console.ReadKey(); }
流程图:
6、Parallel
Parallel并行执行容器,放在该容器内的活动会并发执行,它有一个属性"CompletionCondition",当此属性为真时,有一个顺序执行完成,流程不再等待其他没执行完成的分支,直接往下执行。
Parallel并非多线程并行,而是Parallel是在单线程中轮换执行各分支。当所有分支中的节点都执行完成后,该Parallel节点才继续工作流。所有分支都是在同一条线程上执行。
其作用情景为:只有两个分支都执行才往下走。
示例如下:
以上代码,当CompletionCondition设置为true时,仅仅输出1 2 3 4。如果设置为false,输出1 2 3 4 5 6。
7、Pick,PickBranch(只有最先开始的那条分支会被执行)
- Pick触发容器,提供了基于事件的控制流,Branches集合是触发容器的分支集合,只能添加PickBranch。
- PickBranch只可添加到Pick中,PickBranch.Trigger只能放入触发类Activity,PickBranch.Action当PickBranch.Trigger 被触发时,所要执行的Activity。
- Pick触发容器中可以定义变量。
- 只要有一个PickBranch的Trigger被触发,其他PickBranch就不会被触发了。
- 即使在被执行的PickBranch还没完成时,其他PickBranch也不会被触发。
只输出一个1。
8、ParallelForEach<T>
每次迭代就检查一次CompletionCondition 属性,当其为真时。本环节结束,往下执行。
如上面的例子,当设置CompletionCondition为false时,只输出20。
9、Sequence
Sequence顺序容器,用于存放一系列活动,顺序执行。
如以上顺序输出字符串。
五、流程图
流程图内一共有3个控件,
- Flowchart 流程图容器,里面放置流程,里面能够放置顺序流;
- FlowDecision 用于根据条件判断流程走向(if else);
- FlowSwitch 根据条件,决定流程走向(switch);
当然以上3个控件都是要配合参数传入才能发挥最大的效用。
当然,我在里面设置了一个变量,用于试验Switch。实际上,以上程序输出"是的",与Switch并没太大关系,Switch只是判断FlowChart里的变量。
Flowchart属性
属性 | 说明 |
ValidateUnconnectedNodes | 是否验证所有未连接的节点 |
FlowDecision属性
属性 | 说明 |
Condition | 判断条件表达式 |
FalseLabel | 为False时线上显示的内容 |
TrueLabel | 为True时线条上显示的内容 |
FlowSwitch属性
属性 | 说明 |
Expression | 用于判断的内容switch (xxx就是这个东西) |
六、状态机
1、StateMachine
用于装载状态机工作流。
2、State
状态,它有3个主要属性。
- Entry 进入状态时执行的活动;
- Exit 离开状态时执行的活动;
- Transitions 能够转换到的状态;
3、FinalState
当状态机执行完毕时使用的状态。
只有一个属性Entry,与State的同义。
一个最简单的工作流示例:
定义一个变量i=5,流程输出如下:
七、运行时
1、Persist
持续化活动,当工作流运行至此活动时,调用实例的Persist()方法,执行一次持续化操作。
可参见:http://www.cnblogs.com/kissdodog/p/3993405.html
2、NoPersistScope
非持续化容器,执行此活动时,禁止工作流持续化直至此容器内的活动执行完毕。
3、TerminateWorkflow
当工作流执行此活动时,报一个异常并终止工作流运行。
两个属性:
属性 | 说明 |
Exception | 异常类型 |
Reason | 原因 |
执行此活动,相当于调用了一次流程实例的Terminate()方法。