此示例演示如何管理已挂起的工作流实例。 xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior 的默认操作为 AbandonAndSuspend。 这意味着,在默认情况下,从 xref:System.ServiceModel.WorkflowServiceHost 中承载的某个工作流实例抛出的未处理异常会导致从内存中释放(放弃)该实例,而该实例的持久版本将被标记为已挂起。 已挂起的工作流实例在取消挂起之前无法运行。
此示例演示如何实现用于查询已挂起实例的命令行实用工具,以及如何为用户提供恢复或终止实例的选项。 在此示例中,一个工作流服务有意引发异常,从而使该服务挂起。 然后可以使用命令行实用工具查询该实例,并随后恢复或终止该实例。
演示
xref:System.ServiceModel.WorkflowServiceHost 与xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior和xref:System.ServiceModel.Activities.WorkflowControlEndpointWindows Workflow Foundation (WF) 中。
讨论
本示例中实现的命令行实用工具特定于 .NET Framework 4.6.1 中附带的 SQL 实例存储区实现。 如果您具有该实例存储区的自定义实现,则可以使用特定于您实例存储区的实现替换示例中的 WorkflowInstanceCommand 实现,来改编此实用工具。
所提供的实现直接针对 SQL 实例存储区来运行 SQL 命令以列出挂起的实例,并依赖于添加到 xref:System.ServiceModel.Activities.WorkflowControlEndpoint 的 xref:System.ServiceModel.WorkflowServiceHost,以便恢复或终止实例。
设置、生成和运行示例
-
此示例要求启用以下 Windows 组件:
-
Microsoft Message Queues (MSMQ) Server
-
SQL Server Express
-
-
设置 SQL Server 数据库。
-
从 Visual Studio 2010 命令提示符下,从将执行以下 SuspendedInstanceManagement 示例目录运行"setup.cmd":
-
使用 SQL Server Express 创建持久性数据库。 如果持久性数据库已存在,则删除该数据库并重新创建一个
-
设置持久性数据库。
-
将 IIS APPPOOL\DefaultAppPool 和 NT AUTHORITY\Network Service 添加到设置持久性数据库时定义的 InstanceStoreUsers 角色。
-
-
-
设置服务队列。
-
在 Visual Studio 2010 中,右键单击SampleWorkflowApp项目,然后单击设为启动项目。
-
编译并运行 SampleWorkflowApp 通过按F5。 这将创建所需队列。
-
按Enter停止 SampleWorkflowApp。
-
通过在命令提示符下运行 Compmgmt.msc 来打开计算机管理控制台。
-
展开服务和应用程序,消息队列,专用队列。
-
右键单击ReceiveTx队列,然后选择属性。
-
选择安全选项卡上,并允许Everyone有权接收消息,扫视消息,和将消息发送。
-
-
现在运行示例。
-
在 Visual Studio 2010 中,再次运行该 SampleWorkflowApp 项目而不进行调试通过按Ctrl + F5。 将在控制台窗口中输出两个终结点地址:一个用于应用程序终结点,另一个来自 xref:System.ServiceModel.Activities.WorkflowControlEndpoint。 随后会创建一个工作流实例,该实例的跟踪记录会出现在控制台窗口中。 该工作流实例会引发异常,从而导致该实例挂起或中止。
-
随后可以使用命令行实用工具对这些实例中的任何一个进行进一步操作。 命令行参数的语法如下:
SuspendedInstanceManagement -Command:[CommandName] -Server:[ServerName] -Database:[DatabaseName] -InstanceId:[InstanceId]支持的命令为:
Query、Resume和Terminate。 只有Resume和Terminate才需要 InstanceId 开关。
-
清理(可选)
-
通过在
vs2010命令提示符下运行 Compmgmt.msc 来打开计算机管理控制台。 -
展开服务和应用程序,消息队列,专用队列。
-
删除ReceiveTx队列。
-
若要删除持久性数据库,请运行 cleanup.cmd。
Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:
<InstallDrive>:\WF_WCF_Samples如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:
<InstallDrive>:\WF_WCF_Samples\WF\Application\SuspendedInstanceManagement
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
