Activity功能控件

CodeActivity

CodeActivity提供了一个ExecuteCode事件,可绑定一个(ByVal sender As System.Object, ByVal e As System.EventArgs)格式的Sub方法,每当流程运行到该结点时行绑定到该事件的方法

ExecuteCode事件

流程到该结点时要执行的代码

Private Sub code_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)

End Sub

如果绑定不上，或要改变绑定时报错，可在Workflow1.designer.vb中的手写绑定代码

提供了一个延时的结点，Delay结点就能使实例进入idle状态，并触发引擎的WorkflowIdled事件

已被SqlWorkflowPersistenceService持久化的，Delay状态的实例，在到时后会被刷回引擎，其他状态的实例不会被刷回引擎

SqlWorkflowPersistenceService会不停的刷InstanceState表,发现有状态为Delay的实例，且nextTimer小于当前时间，就执行他。

SqlWorkflowPersistenceService类的一个构造函数，可设置引如何对待进入idle状态的实例,为真时，当工作流进入到一个idle状态时自动unload它

更多的见自定义持久化类的Delay与idle部分

TimeoutDuration 属性

要等待的时间值

格式1: 23:59:59

格式2: 500.23.59.59

InitializeTimeoutDuration 事件

开始进入等待状态前发生该事件

(object sender, EventArgs e)

CallExternalMethodActivity

在工作流内部调用外部方法

1.InterfaceType要绑定到标记为[System.Workflow.Activities.ExternalDataExchange()]的一个接口上

2.MethodName 要绑定到该接口声明的一个方法

3.引擎中要加载ExternalDataExchange服务

4．ExternalDataExchange服务，要加载实现[1]所绑定接口类的实例

5.运行到CallExternalMethodActivity结点后自动调用实例中的方法。用参数映射中的设定传参，得到返回值

6.参数映射见

MethodInvoking事件

开始调用外部方法时发生该事件

private void callExternalMethodActivity1_MethodInvoking(object sender, EventArgs e)

{//方法调用时 }

WorkflowRuntime实例

方法:AddService(obj)

ExternalDataExchangeService实例

方法:AddService(obj)

实例

[System.Workflow.Activities.ExternalDataExchange()]

public interface 外部方法映射接口

{string 一个外部方法(string wxd, string lzm);}

public class 功能类_外部方法 : 外部方法映射接口

{ public string 一个外部方法(string wxd, string lzm)

{ return wxd + lzm;}

}

HandleExternalEventActivity

绑定外部事件(指工作流内部事件在宿主中触发)

1.InterfaceType要绑定到标记为[System.Workflow.Activities.ExternalDataExchange()]的一个接口上

2.EventName 要绑定到该接口声明的一个事件,事件格式最好与Invoked的事件签名一至

(object sender, ExternalDataEventArgs e)

e参数可以通过重写ExternalDataEventArgs类进行括充，下例就重写了

(事件用的是2.0的写法，也可以使用传统写法)

3.引擎中要加载ExternalDataExchange服务

4．ExternalDataExchange服务，要加载实现[1]所绑定接口类的实例

5.运行到HandleExternalEventActivity结点后，会进入idle状态，苏酲时间为9999-12-31

6.只有当宿主中触发绑定的事件后才会继续向下运行。

7.下例中如果所传的“InstanceId”与当前实例的[InstanceId]不一至时会报错

8.触发事件时的两个参数值会传入HandleExternalEventActivity的Invoked事件对应的参数，也会赋给参数映射中的设定

9.触发事件时对象.触发事件("发送对象", 当前操作的实例.InstanceId ) 将要触发该事件的工作流实例的GUID号传入是非常重要的，因为引擎中可能有多个实例在等待该事件，发送工作流实例的GUID号可以告诉引擎是要触发那一个实例事件

10.在实例挂起或没到HandleExternalEventActivity结点时，也可以在外部触发事件，这时当实例运行到该结点时HandleExternalEventActivity就可直接过去，而不用再触发了

Invoked事件

外部事件发生后发生该事件

private void handleExternalEvent_Invoked(object sender, ExternalDataEventArgs e)

e.InstanceId

e.Identity

e.WaitForIdle

e.WorkHandler

e.WorkItem

该事件中的两个参数与参数映射中的设定是一样的

可进行类型转换以得到自定义的扩充: (事件标志)e).自定义存值

public class 功能类_外部事件: 外部事件映射接口 {

public event EventHandler<事件标志> 一个外部事件;

public string 自定义存值;

public void 触发事件(object sender ,Guid id)

{ 事件标志 e = new 事件标志(id);

e.自定义存值 = 自定义存值;

一个外部事件(sender, e);} }

[System.Workflow.Activities.ExternalDataExchange()]

public interface 外部事件映射接口

{event System.EventHandler<事件标志> 一个外部事件;}

宿主

[Serializable()]

public class 事件标志:Workflow.Activities.ExternalDataEventArgs {

private Guid 实例GUID_存值;

public 事件标志(Guid instanceId):base(instanceId)

{this.实例GUID_存值=instanceId; }

public Guid 实例GUID

{get{return this.实例GUID_存值;} set{this.实例GUID_存值 = value;}}

public string 自定义存值; }

//可以重写ExternalDataEventArgs，以实与在事件参数中传递自定义信息

WorkflowRuntime实例

方法:AddService(obj)

ExternalDataExchangeService实例

方法:AddService(obj)

对象

'触发外部事件的一个方法

对象.自定义存值= "wxd"

'[发送对象]:不能将[当前操作的实例.WorkflowRuntime]发回去

对象.触发事件("发送对象", 当前操作的实例.InstanceId)

结束外部事件的等待状态

1.设计工作流时，使用一个listen监听,其中一个分支是HandleExternalEventActivity,另一个分支是Delay，在Delay中设定一个等待超时

2.在引擎中直接将实例终止

3.对事件队列发送终止信息

Dim 队列集合As ReadOnlyCollection(Of WorkflowQueueInfo) = 当前操作的实例.GetWorkflowQueueData()

For Each 队列As WorkflowQueueInfo In 队列集合

Dim 事件队例As EventQueueName = TryCast(队列.QueueName, EventQueueName)

If 事件队例IsNot Nothing Then

'handleExternalEventActivity1控件为假时，不会执行到该单元

'get activity that is waiting for event

'获得到activity以等侍事件

Dim 阻塞的Activity As ReadOnlyCollection(Of String) = 队列.SubscribedActivityNames

'等待事件的控件名

Console.WriteLine(阻塞的Activity.Item(0).ToString())

' this event is never going to arrive eg. employee left the company

' lets send an exception to this queue

' it will either be handled by exception handler that was modeled in workflow

' or the runtime will unwind running compensation handlers and exit the workflow

'这个事件从来不会到达eg ，

'让我们发送一个错误到这个队列

'它将绑定到exception handler,这是workFlow的一种模式

'或者运行时将unwind[解开，打开]运行补偿绑定，并且退出工作流

Console.WriteLine(事件队例.MethodName)

Console.WriteLine(事件队例.InterfaceType.Name)

Dim ec As New Exception("wxd添加的自定义错误信息")

当前操作的实例.EnqueueItem(队列.QueueName, ec, Nothing, Nothing)

End If

SuspendActivity

一个挂起流程的结点，与在宿主中使用[实例.Suspend("参数")]效果一样

该结点与[实例.Suspend("参数")]一样会触发引擎的WorkflowSuspended事件

引擎的WorkflowSuspended事件的 e.Error就是Error属性设置的值

Error属性

就是[实例.Suspend("参数")]中的参数值，该”参数值”可以被WorkflowSuspended事件与跟踪服务接收

引擎的WorkflowSuspended事件的 e.Error就是Error属性设置的值

terminateActivity

一个终止流程的结点，,与在宿主中使用[实例.Terminate("该实例已被宿主Terminate")]效果一样

该结点与[实例.Terminate("该实例已被宿主Terminate")]一样会触发引擎的OnWorkflowTerminated事件,

引擎的OnWorkflowTerminated事件的e.Exception.Message就是Error属性设置的值

Error属性

就是[实例.Terminate("参数")]中的参数值，该”参数值”可以被OnWorkflowTerminated事件与跟踪服务接收

引擎的OnWorkflowTerminated事件的e.Exception.Message就是Error属性设置的值

ThrowActivity

1.一个抛出异常的结点

2.该结点将一个自定义的异常对象抛给引擎,会触发引擎的OnWorkflowTerminated事件

3.引擎OnWorkflowTerminated事件的e.Exception可得到

4.使用该结点，与在代码中使用[throw 异常] 的不同之处是[throw 异常] 在调试状态会使编译器停屏

[Serializable]

public class 异常A : System.Exception

{

public 异常A(string s) : base(s)

{

}

public 异常A Fault1 = new 工作流模板.异常A("一个自定义的异常");

InvokeWebServiceActivity

调用WebService方法

属性

ProxyClass

SoapHttpClientProcotol 类对实要调用的Webservice的实现

当添加该控件时，会出现一个添加Web引用的向导，可在向导中完成对SoapHttpClientProcotol的实现

URL

要调用的Web Service的URL

MethodName

调用Web Services的方法名

设计器会跟据该方法参数出现对应的[参数映射向导]

事件

Invoked	执行完成后
Invoking	要执行时

SessionId

WF 支持在一个Workflow中通过cookie 支持多个InvokeWebServiceActivity的调用在一个Session中

这时候，你需要设置InvokeWebServiceActivity的SessionId属性，如果你将一个Workflow中的多个InvokeWebServiceActivity的SessionId 设置成相同的，那么WF在调用和执行完第一个InvokeWebServiceActivity 之后，也会以相同的cookie 传回给Web Service的服务器端，以确保服务器端能够跟踪到客户端的情况。SessionId 是一个字符串，如果是空字符串，则表示会启用一个新的Session。