.NET Framework 4.5 中的 Windows Workflow Foundation 中的新增功能

项目
05/10/2023

.NET Framework 4.5 中的 Windows Workflow Foundation (WF) 引入了许多新功能，例如新活动、设计器功能和工作流开发模型。重新承载的工作流设计器支持 .NET Framework 4.5 中引入的许多（但不是全部）新工作流功能。有关受支持的新功能的详细信息，请参阅重新托管的工作流设计器支持的新 Workflow Foundation 4.5 功能。有关迁移 .NET Framework 3.0 和 .NET Framework 3.5 工作流应用程序以使用最新版本的详细信息，请参阅迁移指南。本文概述了 .NET Framework 4.5 中引入的新工作流功能。

警告

.NET Framework 4.5 中引入的新 Windows Workflow Foundation 功能不适用于针对以前版本的框架的项目。如果面向 .NET Framework 4.5 的项目重新面向以前版本的框架，则可能会发生多个问题。

C# 表达式在设计器中将替换为消息“在 XAML 中设置了值”。
将发生许多生成错误，包括以下错误。

文件格式与当前目标框架不兼容。若要转换文件格式，请显式保存文件。在保存文件并重新打开设计器之后，此错误将会消失。

工作流版本控制

.NET Framework 4.5 引入了几个基于新的 WorkflowIdentity 类的工作流版本控制功能。 WorkflowIdentity 为工作流应用程序提供了一种通过定义来映射持久化工作流实例的机制。

使用 WorkflowApplication 承载的开发人员可以使用 WorkflowIdentity 来启用并行承载多个版本的工作流。可以使用新的 WorkflowApplicationInstance 类来加载持久化工作流实例，然后，主机可以使用 DefinitionIdentity 在实例化 WorkflowApplication 时提供工作流定义的正确版本。有关详细信息，请参阅使用 WorkflowIdentity 和版本控制和如何：并排托管工作流的多个版本。
WorkflowServiceHost 现在是多版本主机。在部署工作流服务的新版本时，将使用新的服务创建新实例，但会使用以前的版本来完成现有实例。有关详细信息，请参阅 WorkflowServiceHost 中的并行版本控制。
引入了动态更新，其提供了一种更新持久化工作流实例定义的机制。有关详细信息，请参阅动态更新和如何：更新正在运行的工作流实例的定义。
SqlWorkflowInstanceStoreSchemaUpgrade.sql 数据库脚本旨在用于升级使用 .NET Framework 4 数据库脚本创建的持久性数据库。此脚本会更新 .NET Framework 4 持久性数据库，使之支持 .NET Framework 4.5 中引入的全新版本控制功能。数据库中的持久化工作流实例将获得默认的版本控制值，然后就可以参与并行执行和动态更新。有关详细信息，请参阅升级 .NET Framework 4 持久性数据库以支持工作流版本控制。

活动

内置活动库包含新活动和现有活动的新功能。

NoPersist 范围

NoPersistScope 是一个在执行 NoPersistScope 的子活动时防止工作流持久保存的新容器活动。此活动在工作流不适合持久保存的方案中十分有用，例如，当工作流使用计算机特定资源（如文件句柄）时或在执行数据库事务期间。以前，为防止在活动执行期间出现持久性，需要一个使用 NativeActivity 的自定义 NoPersistHandle。

新流程图功能

流程图将针对 .NET Framework 4.5 进行更新，并具有以下新功能：

DisplayName 或 FlowSwitch<T> 活动的 FlowDecision 属性是可编辑的。这样，活动设计器就可以显示有关该活动的用途的详细信息。
流程图具有一个名为 ValidateUnconnectedNodes 的新属性；此属性的默认值为 False。如果此属性设置为 True，则未连接的流程图节点将产生验证错误。

支持部分信任

在 .NET Framework 4 中的工作流需要完全信任的应用程序域。在 .NET Framework 4.5 中，工作流可以在部分信任环境中运行。在部分信任环境中，可以使用第三方组件而无需为其授予主机资源的完全访问权限。关于在部分信任中运行的工作流，请注意以下几点：

在部分信任下，不支持使用 Interop 活动中包含的旧组件（包括规则）。
不支持 WorkflowServiceHost 中在部分信任下运行的工作流。
在部分信任方案中持久保留异常是一种潜在安全威胁。若要禁用异常的持久保留，必须将扩展类型 ExceptionPersistenceExtension 添加至项目，以便取消持久化异常。下面的代码示例演示如何实现此类型。
```
public class ExceptionPersistenceExtension
{
    public ExceptionPersistenceExtension()
    {
        this.PersistExceptions = false;
    }
    public bool PersistExceptions { get; set; }
}
```
如果无需对异常进行序列化，请确保在 NoPersistScope 内使用异常。
活动作者应重写 CacheMetadata 以避免让工作流运行时针对该类型自动执行反射。参数和子活动必须为非 null，并且 Bind 必须被显式调用。有关替代 CacheMetadata 的详细信息，请参阅使用 CacheMetadata 公开数据。此外，必须在 CacheMetadata 中显式创建类型为 internal 或 private 的参数的实例，以避免由反射创建这些实例。
这些类型不会使用 ISerializable 或 SerializableAttribute 来进行序列化；要进行序列化的类型必须支持 DataContractSerializer。
使用 LambdaValue<TResult> 的表达式需要 RestrictedMemberAccess，因此不能在部分信任下使用。使用 LambdaValue<TResult> 的工作流应将这些表达式替换为派生自 CodeActivity<TResult> 的活动。 .
在部分信任下，不能使用 TextExpressionCompiler 或 Visual Basic 承载的编译器来编译表达式，但是可以运行以前编译的表达式。
使用 2 级透明度的单个程序集不能在 .NET Framework 4、完全信任的 .NET Framework 4.6.1 和部分信任的 .NET Framework 4.6.1 中使用。

新设计器功能

设计器搜索

为了使较大的工作流程更易于管理，现在可以按关键字来搜索工作流。此功能仅在 Visual Studio 中提供，未在重新承载的设计器中提供。提供了两种搜索：

快速查找，通过“Ctrl+F”或“编辑”、“查找和替换”、“快速查找”启动。
在文件中查找，通过“Ctrl+Shift+F”或“编辑”、“查找和替换”、“在文件中查找”启动。

请注意，不支持替换。

快速查找

在工作流中搜索的关键字将匹配下列设计器项：

Activity 对象、FlowNode 对象、State 对象、Transition 对象以及其他自定义流控制项的属性。
变量
参数
表达式

在设计器上的 ModelItem 树上执行快速查找。快速查找不会查找在工作流定义中导入的命名空间。

在文件中查找

在工作流中搜索的关键字将匹配工作流文件的实际内容。搜索结果将显示在 Visual Studio 查找结果视图窗格中。双击结果项将会定位到包含工作流设计器中的匹配项的活动。

删除变量和自变量设计器中的上下文菜单项

在 .NET Framework 4 中，只能使用键盘来删除设计器中的变量和参数。从 .NET Framework 4.5 开始，可以使用上下文菜单来删除变量和参数。

以下屏幕快照显示了变量和自变量设计器的上下文菜单。

使用顺序进行自动环绕

由于工作流或特定容器活动（如 NoPersistScope）只能包含单个主体活动，因此添加第二个活动需要开发人员删除第一个活动，请添加一个 Sequence 活动，然后将两个活动都添加到该顺序活动中。从 .NET Framework 4.5 开始，向设计器图面添加第二个活动时，将会自动创建 Sequence 活动以包装两个活动。

以下屏幕快照显示了 WriteLine 的 Body 中的 NoPersistScope 活动。

NoPersistScope 活动正文中的 WriteLine 活动。

以下屏幕快照显示了在第一个 Sequence 下面丢弃第二个时在 Body 中自动创建的 WriteLine 活动。

在 NoPersistScope 正文中自动创建的序列。

平移模式

若要更轻松地在设计器中浏览大型工作流，可以启用平移模式；通过此模式，开发人员可以单击并拖动工作流的可见部分将其移动，而无需使用滚动条。用于激活平移模式的按钮位于设计器的右下角。

下面的屏幕快照显示了位于工作流设计器右下角的平移按钮。

也可以使用鼠标中键或空格键来平移工作流设计器。

多选

通过拖动围绕活动的矩形（未启用平移模式时）或通过按住 Ctrl 键并逐一单击所需的活动，可以一次选择多个活动。

也可以在设计器中拖动并放置多个选择的活动，并使用上下文菜单与这些活动交互。

工作流项的大纲视图

为了更加方便地浏览分层工作流，工作流的组件显示在树样式的大纲视图中。大纲视图显示在“文档大纲”视图中。若要打开此视图，请从顶部的菜单中依次选择“视图”、“其他窗口”、“文档大纲”，或按 Ctrl W、U。单击大纲视图中的节点将会定位到工作流设计器中的相应活动，并且该大纲视图将会更新以显示在设计器中选择的活动。

入门教程中已完成的工作流的以下屏幕快照显示了包含顺序工作流的大纲视图。

屏幕截图显示 Visual Studio 中包含顺序工作流的大纲视图。

C# 表达式

在 .NET Framework 4.5 之前，工作流中的所有表达式只能用 Visual Basic 来编写。在 .NET Framework 4.5 中，Visual Basic 表达式仅用于使用 Visual Basic 创建的项目。 Visual C# 项目现在将 C# 用于表达式。提供了功能完全的 C# 表达式编辑器，包括语法突出显示和 Intellisense 等功能。在使用 Visual Basic 表达式的以前版本中创建的 C# 工作流项目仍可继续使用。

将在设计时对 C# 表达式进行验证。 C# 表达式中的错误将标有红色波浪形下划线。

有关 C# 表达式的详细信息，请参阅 C# 表达式。

shell 栏和标头项的更多可见性控制

在重新承载的设计器中，某些标准 UI 控件可能对于给定的工作流没有意义，并可能已关闭。在 .NET Framework 4 中，此自定义仅受设计器底部的 shell 栏支持。在 .NET Framework 4.5 中，可通过用合适的 ShellHeaderItemsVisibility 值设置 WorkflowShellHeaderItemsVisibility 来调整设计器顶部 shell 标头项的可见性。

在流程图和状态机工作流中自动连接和自动插入

在 .NET Framework 4 中，必须手动添加流程图工作流中节点之间的连接。在 .NET Framework 4.5 中，流程图和状态机节点具有自动连接点，这些自动连接点会在将一个活动从工具箱拖到设计器图面上时变为可见。将活动放置在这些点中的一个点上会自动添加该活动以及必要的连接。

下面的屏幕快照显示了从工具箱中拖动活动时变为可见的附属点。

流程图起始节点显示自动连接点

也可以将活动拖动到流程图节点和状态之间的连接上，以在两个其他节点之间自动插入该节点。以下屏幕快照显示了突出显示的连接线，可在此连接线处从工具箱拖动并放置活动。

放置活动的自动插入处理

设计器批注

为促进开发较大型的工作流，设计器现在支持添加批注以帮助跟踪设计过程。可以向活动、状态、流程图节点、变量和自变量添加批注。以下屏幕快照显示了用于将批注添加到设计器的上下文菜单。

调试状态

在 .NET Framework 4 中，非活动元素不支持调试断点，因为这些元素不是执行单位。此版本提供了一种向 State 对象添加断点的机制。若在 State 上设置了断点，则执行将在计划了状态入口活动或触发器之前、状态发生转换时中断。

在设计器中定义和使用 ActivityDelegate 对象

.NET Framework 4 中的活动使用 ActivityDelegate 对象来公开执行点，在这些执行点处，工作流的其他部分可与工作流的执行交互；但是，使用这些执行点通常需要数量相当大的代码。在此版本中，开发人员可以使用工作流设计器来定义和使用活动委托。有关详细信息，请参阅如何：在工作流设计器中定义和使用活动委托。

生成时验证

在 .NET Framework 4 中，不会将生成工作流项目期间的工作流验证错误计为生成错误。这意味着即使存在工作流验证错误，工作流项目的生成也可能成功。在 .NET Framework 4.5 中，工作流验证错误会导致生成失败。

设计时后台验证

在 .NET Framework 4 中，会把工作流作为前台进程进行验证，这可能会在复杂或耗时的验证过程中会阻止 UI。工作流验证现在发生在后台线程上，因此不会阻止 UI。

位于 XAML 文件中的单独位置处的视图状态

在 .NET Framework 4 中，工作流的视图状态信息存储在 XAML 文件中的许多不同位置。这对于想直接读取 XAML 或编写用于删除视图状态信息的代码的开发人员来说很不方便。在 .NET Framework 4.5 中，XAML 文件中的视图状态信息序列化为 XAML 文件中的单独元素。开发人员可以轻松地查找和编辑活动的视图状态信息，或者完全删除视图状态。

表达式扩展性

在 .NET Framework 4.5 中，我们为开发人员提供了一种创建自己的表达式并可将表达式创作体验插入到工作流设计器中的方法。

重新承载的设计器中 Workflow 4.5 功能的选择性加入

为保留向后兼容性，默认情况下，包括在 .NET Framework 4.5 中的一些新功能不会在重新承载的设计器中启用。这是为了确保使用重新承载的设计器的现有应用程序不会由于更新至最新版本而中断。若要启用重新承载的设计器中的新功能，可将 TargetFrameworkName 设置为“.NET Framework 4.5”，或设置 DesignerConfigurationService 的各成员以启用各个功能。

新工作流开发模型

除流程图和顺序工作流开发模型外，此版本还包括状态机工作流和协定优先工作流服务。

状态机工作流

状态机工作流是作为 Microsoft .NET Framework 4 平台更新 1 中 .NET Framework 4（版本 4.0.1）的一部分引入的。此更新包括多个新类和活动，允许开发人员创建状态机工作流。这些类和活动已针对 .NET Framework 4.5 进行更新。更新包括：

能够对状态设置断点
能够在工作流设计器中复制和粘贴转换
设计器支持共享触发器转换创建
用于创建状态机工作流的活动，包括：StateMachine、State 和 Transition

以下屏幕截图显示了入门教程步骤（如何：创建状态机工作流）中已完成的状态机工作流。

此图显示已完成的状态机工作流。

有关创建状态机工作流的更多信息，请参阅状态机工作流。

协定优先工作流开发

通过协定优先工作流开发工具，开发人员可以先用代码设计一个协定，然后，通过在 Visual Studio 中进行几次单击，即可在工具箱中自动生成表示每个操作的活动模板。这些活动随后用于创建实现由该协定定义的操作的工作流。工作流设计器将对该工作流服务进行验证，以确保实现这些操作并且工作流的签名与协定签名匹配。开发人员还可以将工作流服务与所实现的协定的集合进行关联。有关协定优先工作流服务开发的详细信息，请参阅如何：创建使用现有服务协定的工作流服务。