WorkflowRuntime

介绍

System.Workflow.Runtime.WorkflowRuntime

文件: system.workflow.runtime.dll

 在工作流的运行环境（宿主）中,为工作流提供运行的引擎

1．WorkflowRuntime在宿主中以自已独立的线程运行例

2．WorkflowRuntime可以加载多个工作流实例，每个工作流实例在WorkflowRuntime有独立的线程

3．同一宿主可可以实例化多个引擎，他们可以同时工作

基本使用

配置并启动引擎

Dim 引擎  As New WorkflowRuntime() '定义引擎实例

 

引擎.AddService(加载服务)'向引擎加载服务

 

AddHandler 引擎.事件, AddressOf 事件回调程序  '为引擎绑定事件

 

引擎.StartRuntime() '启动引擎

在引擎中创建

并运行实例

Dim 工作流模板类As Type   '定义一个Type型对象

 

工作流模板类= GetType(Workflow1)  '得要要运行的工作流的类型名

 

Dim 实例  As WorkflowInstance  '定义一个要由引擎运行的工作流实例

 

'用引擎.CreateWorkflow方法返回实例,此时该实例已在引擎内创建，但还没启动

实例= 引擎.CreateWorkflow(工作流模板类)

 

实例.Start()  '运行引擎中的实例

停止引擎

 

'停止引擎

引擎.StopRuntime()

 

方法
如何加载服务见WWF_持久化

加载

服务

 

得到

服务

AddService

添加一个服务到工作流引擎

引擎.AddService (object)

RemoveService

从工作流引擎移除一个服务

 引擎.RemoveService(object)

GetService

从加载到引擎中的指定服务

Function GetService (serviceType As Type) As Object

Function GetService(Of T)() As T

GetAllServices

得到所有加载到引擎中的服务

Function GetAllServices(Of T) As ReadOnlyCollection(Of T)

Function GetAllServices (serviceType As Type) As ReadOnlyCollection(Of Object)

建立

实例

 

得到

实例

CreateWorkflow

在引擎中建立一个实例，并将该实例返回

使用工作流类开为参数

Function CreateWorkflow (   workflowType As Type ) As WorkflowInstance

 

Function CreateWorkflow (workflowType As Type,参数 As Dictionary(Of String, Object)) As WorkflowInstance

 

使用一个XmlReader为参数

Function CreateWorkflow(ByVal workflowDefinitionReader As XmlReader) As WorkflowInstance

 

Function CreateWorkflow(ByVal workflowDefinitionReader As XmlReader, ByVal rulesReader As XmlReader, ByVal 参数As Dictionary(Of String, Object)) As WorkflowInstance

GetLoadedWorkflows

得到内存中所有工作流的集合

Function GetLoadedWorkflows As ReadOnlyCollection(Of WorkflowInstance)

GetWorkflow

使用 Guid参数，从引擎中得到指定ID的工作流实例

Function GetWorkflow(ByVal instanceId As Guid) As WorkflowInstance

引擎

控制

StartRuntime

启用引擎

引擎.StartRuntime()       

StopRuntime

停止引擎，停止引擎后，引擎并没有释放，引擎中的实例也存中，只是所有的执行都被系统级挂起，当重新启动引擎时，所有的实例还可粥运行

引擎.StopRuntime()

资源释放

Dispose

释放工作流引擎资源

引擎.Dispose()

 

事件

有些事件将在具体实用中详细说明

ByVal sender As Object返回引发该事件的工作流引擎，当一个宿主实例化了多个引擎，而这些引擎又绑定到同一组事件上时，可以使用sender参数得到触发该事件的引擎

ServicesException

_NotHandled

Occurs when a service that is derived from

the WorkflowRuntimeService class calls RaiseServicesExceptionNotHandledEvent（与加载服务有关）

 Sub OnServicesExceptionNotHandled(ByVal sender As Object, ByVal e As ServicesExceptionNotHandledEventArgs)

        'ServicesExceptionNotHandledEventArgs

        ' e.Exception异常信息

        ' e.WorkflowInstanceId 工作流实例的GUID

Started

引擎启动后

    Sub OnStarted(ByVal sender As Object, ByVal e As WorkflowRuntimeEventArgs)

        'WorkflowRuntimeEventArgs

        'e.IsStarted 是否启动

Stopped

引擎停止后

    Sub OnStopped(ByVal sender As Object, ByVal e As WorkflowRuntimeEventArgs)

        'WorkflowRuntimeEventArgs

        'e.IsStarted 是否启动

WorkflowAborted

引擎中的某个实例:被中断执行后

    Sub OnWorkflowAborted(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowCompleted

引擎中的某个实例:完成后.

    Sub OnWorkflowCompleted(ByVal sender As Object, ByVal e As WorkflowCompletedEventArgs)

        'WorkflowCompletedEventArgs

        ' e.OutputParameters用参数方式与实例的属性进行通信

        ' e.WorkflowInstance 工作流实例

        ' e.WorkflowInstance 引发该事件的实例

WorkflowCreated

引擎中的某个实例: 被创建后

    Sub OnWorkflowCreated(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowIdled

引擎中的某个实例: 进入空闭状态,

如Delay控件,CallExternalMethod控件,

会触发该事件

    Sub OnWorkflowIdled(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowLoaded

引擎中的某个实例: 加载到内存时

    Sub OnWorkflowLoaded(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowPersisted

引擎中的某个实例: 进入持久化状态后，

注，如果没有加载持久化服务，而调用持久化方法，该事件仍会触发，但实例并没有被持久化

    Sub OnWorkflowPersisted(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowResumed

引擎中的某个实例:从挂起状态恢复后

    Sub OnWorkflowResumed(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowStarted

引擎中的某个实例:被启动后

    Sub OnWorkflowStarted(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

WorkflowSuspended

引擎中的某个实例:被暂停后，如Suspend控件会触发该事件

    Sub OnWorkflowSuspended(ByVal sender As Object, ByVal e As WorkflowSuspendedEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例

        'e.Error 暂停信息

WorkflowTerminated

引擎中的某个实例:终止后，如工作流内部的异常会引起终止

    Sub OnWorkflowTerminated(ByVal sender As Object, ByVal e As WorkflowTerminatedEventArgs)

        'WorkflowTerminatedEventArgs

        ' e.Exception 异常

        ' e.WorkflowInstance 工作流实例

WorkflowUnloaded

引擎中的某个实例:从内存中移出后

    Sub OnWorkflowUnloaded(ByVal sender As Object, ByVal e As WorkflowEventArgs)

        'WorkflowEventArgs

        'e.WorkflowInstance 工作流实例