必须熟悉 .NET Framework 外接程序模型。有关更多信息，请参见外接程序概述。

本主题使用以下示例来演示 WPF 如何扩展 .NET Framework 外接程序模型：

• 外接程序返回 UI 示例，在本主题的外接程序返回用户界面一节中介绍。

• 外接程序是 UI 示例，在本主题的外接程序为用户界面一节中介绍。

• 具有多个 UI 的外接程序示例，在本主题的从一个外接程序返回多个用户界面一节中介绍。

• 以 XBAP 为宿主应用程序的外接程序示例，在本主题的外接程序和 XAML 浏览器应用程序一节中介绍。

为了在应用程序中引入新功能，需要对其进行重新编译和重新部署。为避免这些复杂过程，应用程序实现了扩展机制，使开发人员（包括第一方和第三方）能够创建与应用程序集成的其他应用程序。要支持这种扩展，最常用的方法是使用外接程序（也称为“加载项”和“插件”）。通过外接程序公开扩展性的实际应用程序示例包括：

• Internet Explorer 加载项。

• Windows Media Player 插件。

• Visual Studio 外接程序。

例如，通过 Windows Media Player 外接程序模型，第三方开发人员可以实现“插件”，从而以各种方式对 Windows Media Player 进行扩展，包括为 Windows Media Player 本身不支持的媒体格式（例如 DVD、MP3）创建解码器和编码器，扩展音频效果和外观。尽管有一些实体和行为是所有外接程序模型共有的，但生成的每个外接程序模型都是为了公开某个应用程序的特有功能。

典型外接程序扩展解决方案的三大要素是“协定”、“外接程序”和“宿主应用程序”。协定定义了外接程序与宿主应用程序之间的两种集成方式：

• 外接程序集成宿主应用程序所实现的功能。

• 宿主应用程序公开供外接程序集成的功能。

要使外接程序能发挥作用，宿主应用程序需要在运行时找到并加载它们。因此，支持外接程序的应用程序需要额外执行以下操作：

• 发现：查找遵循宿主应用程序所支持的协定的外接程序。

• 激活：加载、运行外接程序并与之建立通信。

• 隔离：使用应用程序域或进程建立隔离边界，避免外接程序的潜在安全问题和执行问题对应用程序造成影响。

• 通信：通过调用方法和传递数据，允许外接程序和宿主应用程序跨过隔离边界相互通信。

• 生存期管理：以可预测的干净方式加载和卸载应用程序域和进程（请参见应用程序域概述）。

• 版本管理：确保在创建宿主应用程序或外接程序的新版本后，它们仍可进行通信。

总之，开发一个可靠的外接程序模型不是一项简单的任务。为此，.NET Framework 提供了一种用于生成外接程序模型的基础结构。

说明：
有关外接程序的详尽信息，请参见外接程序概述。

.NET Framework 外接程序模型在 System.AddIn 命名空间中，它包含一组类型，用于简化外接程序扩展的开发过程。.NET Framework 外接程序模型的基本单元是“协定”，它定义宿主应用程序与外接程序之间的通信方式。协定向宿主应用程序公开特定于宿主应用程序的协定视图。同样，向外接程序公开的是特定于外接程序的协定视图。通过适配器，宿主应用程序和外接程序可以在它们各自的协定视图之间进行通信。协定、视图和适配器称为管线段，一组相关的管线段组成一条“管线”。在管线的基础上，.NET Framework 外接程序模型才能支持发现、激活、安全隔离、执行隔离（同时使用应用程序域和进程）、通信、生存期管理和版本管理。

所有这些支持使得开发人员能够生成与宿主应用程序的功能相集成的外接程序。但是，某些情况下，宿主应用程序需要显示外接程序所提供的 UI。由于 .NET Framework 中的每种呈现方法都有自己的 UI 实现模型，因此 .NET Framework 外接程序模型不支持任何专用呈现方法。而是由 WPF 对 .NET Framework 外接程序模型进行扩展，支持外接程序的 UI。

WPF 与 .NET Framework 外接程序模型相结合，能够实现多种要求宿主应用程序显示外接程序 UI 的方案。具体说来，这些方案由 WPF 使用以下两种编程模型实现：

1. 外接程序返回用户界面。外接程序按照协定的定义，通过方法调用将 UI 返回给宿主应用程序。此方案可用于以下情况：

   • 外接程序返回的 UI 的外观依赖于仅在运行时存在的数据或条件，例如动态生成的报告。

   • 外接程序提供的服务 UI 不同于可以使用此外接程序的宿主应用程序 UI。

   • 外接程序主要为宿主应用程序执行某项服务，并通过 UI 向宿主应用程序报告状态。

2. 外接程序为用户界面。如协定所定义的那样，外接程序是一个 UI。此方案可用于以下情况：

   • 凡外接程序提供的服务都需要显示，例如广告。

   • 外接程序提供的服务 UI 由可以使用该外接程序的所有宿主应用程序（如计算器或颜色选取器）共用。

这些方案要求 UI 对象可以在宿主应用程序和外接应用程序域之间传递。由于 .NET Framework 外接程序模型依靠远程处理在应用程序域之间进行通信，所以在应用程序域之间传递的对象必须是可远程处理的。

可远程处理的对象是一个类的实例，执行下面的一个或多个任务：

• 从 MarshalByRefObject 类派生。

• 实现 ISerializable 接口。

• 应用 SerializableAttribute 属性。

说明：
有关创建可远程处理的 .NET Framework 对象的更多信息，请参见使对象可远程处理。有关远程处理的概述，请参见 .NET Framework 远程处理概述。

WPF UI 类型不可远程处理。为解决此问题，WPF 扩展了 .NET Framework 外接程序模型，允许从宿主应用程序显示外接程序创建的 WPF UI。这种支持由 WPF 通过两种类型提供：INativeHandleContract 接口和由 FrameworkElementAdapters 类实现的两个静态方法：ContractToViewAdapter 和 ViewToContractAdapter。在上层，这些类型和方法的用法如下：

1. WPF 要求由外接程序提供的 UI 是直接或间接从 FrameworkElement（如形状、控件、用户控件、布局面板和页面）派生的类。

2. 无论协定在何处声明在外接程序和宿主应用程序之间传递 UI，都必须将 UI 声明为 INativeHandleContract（而不是 FrameworkElement）；INativeHandleContract 是可以越过隔离边界传递的外接程序 UI 的可远程处理表示形式。

3. 在从外接应用程序域传递之前，通过调用 ViewToContractAdapter 将 FrameworkElement 打包为 INativeHandleContract。

4. 在传递到宿主应用程序的应用程序域之后，必须通过调用 ContractToViewAdapter 将 INativeHandleContract 重新打包为 FrameworkElement。

INativeHandleContract、ContractToViewAdapter 和 ViewToContractAdapter 的用法取决于具体情况。下面几节介绍每个编程模型的详细信息。

若要使外接程序向宿主应用程序返回 UI，需要满足以下要求：

1. 必须按照 .NET Framework 外接程序和扩展性文档的描述，创建宿主应用程序、外接程序和管线。

2. 协定必须实现 IContract，并且为了返回 UI，协定必须使用 INativeHandleContract 类型的返回值声明方法。

3. 在外接程序和宿主应用程序之间传递的 UI 必须直接或间接从 FrameworkElement 派生。

4. 外接程序返回的 UI 在越过隔离边界之前必须从 FrameworkElement 转换为 INativeHandleContract。

5. 返回的 UI 在越过隔离边界之后必须从 INativeHandleContract 转换为 FrameworkElement。

6. 宿主应用程序显示返回的 FrameworkElement。

有关演示如何实现返回 UI 的外接程序的示例，请参见如何：创建返回 UI 的外接程序。有关完整示例，请参见外接程序返回 UI 示例。

当外接程序为 UI 时，必须满足以下要求：

1. 必须按照 .NET Framework 外接程序和扩展性文档的描述，创建宿主应用程序、外接程序和管线。

2. 外接程序的协定接口必须实现 INativeHandleContract。

3. 传递到宿主应用程序的外接程序必须直接或间接从 FrameworkElement 派生。

4. 在越过隔离边界之前，必须将外接程序从 FrameworkElement 转换为 INativeHandleContract。

5. 在越过隔离边界之后，必须将外接程序从 INativeHandleContract 转换为 FrameworkElement。

6. 宿主应用程序显示返回的 FrameworkElement。

有关演示如何实现返回 UI 的外接程序的示例，请参见如何：创建返回 UI 的外接程序。有关完整示例，请参见外接程序是 UI 示例。

外接程序通常提供多个 UI 供宿主应用程序进行显示。例如，考虑一个本身为 UI 的外接程序，它同时还向宿主应用程序提供状态信息，也是一个 UI。像这样的外接程序可以通过结合使用外接程序返回用户界面和外接程序为用户界面两种模型中的技术来实现。

有关演示此方法的完整示例，请参见具有多个 UI 的外接程序示例。

到目前为止，在所使用的示例中，宿主应用程序都安装为独立应用程序。实际上，如果满足以下附加的生成和实现要求，XAML 浏览器应用程序 (XBAP) 也可以承载外接程序：

• 必须专门配置 XBAP 应用程序清单，以便将管线（文件夹和程序集）和外接程序程序集下载到客户端计算机上的 ClickOnce 应用程序缓存中 XBAP 所在的文件夹中。

• 用于发现和加载外接程序的 XBAP 代码必须将用于 XBAP 的 ClickOnce 应用程序缓存用作管线和外接程序位置。

• 如果外接程序引用位于源站点的松散文件，则 XBAP 必须将外接程序加载到专门的安全性上下文中；在由 XBAP 承载时，外接程序只能引用位于宿主应用程序的源站点的松散文件。

下面几个小节将详细介绍这些任务。

说明：
有关承载外接程序的 XBAP 的完整示例，请参见以 XBAP 为宿主应用程序的外接程序示例。

配置用于 ClickOnce 部署的管线和外接程序

从应用程序基使用管线和外接程序

访问宿主的源站点

在最上层，可以看出，WPF 使用 INativeHandleContract、ViewToContractAdapter 和 ContractToViewAdapter 使 .NET Framework 外接程序实现了 UI（直接或间接从 FrameworkElement 派生）。结果是向宿主应用程序返回从宿主应用程序 UI 显示的 FrameworkElement。

对于简单的 UI 外接程序方案，这些内容已足够详细，可以满足开发人员的需要。对于更复杂的方案，特别是那些试图使用附加 WPF 服务（如布局、资源和数据绑定）的方案，需要更为深入地掌握 WPF 如何扩展支持 UI 的 .NET Framework 外接程序模型的知识，才能理解它的优点和限制。

基本上，WPF 不会将 UI 从外接程序传递到宿主应用程序，相反，WPF 通过使用 WPF 互操作性传递 UI 的 Win32 窗口句柄。因此，当 UI 从外接程序传递到宿主应用程序时，会发生以下情况：

• 在外接程序端，WPF 获得一个将由宿主应用程序显示的 UI 的窗口句柄。此窗口句柄由内部 WPF 类封装，该类从 HwndSource 派生并实现 INativeHandleContract。此类的实例由 ViewToContractAdapter 返回，并从外接程序的应用程序域封送到宿主应用程序的应用程序域。

• 在宿主应用程序端，WPF 将 HwndSource 重新打包为从 HwndHost 派生并使用 INativeHandleContract 的内部 WPF 类。ContractToViewAdapter 将此类的实例返回到宿主应用程序。

存在 HwndHost，用于显示来自 WPF UI 的由窗口句柄标识的 UI。有关更多信息，请参见 WPF 和 Win32 互操作概述。

总之，存在 INativeHandleContract、ViewToContractAdapter 和 ContractToViewAdapter，使得 WPF UI 的窗口句柄能够从外接程序传递到宿主应用程序，并在宿主应用程序中由 HwndHost 封装并显示宿主应用程序的 UI。

说明：
由于宿主应用程序获取 HwndHost，因此宿主应用程序无法将 ContractToViewAdapter 返回的对象转换为由外接程序实现的类型（如 UserControl）。

从本质上，HwndHost 具有某些限制，这些限制会影响宿主应用程序使用它们的方式。不过，WPF 针对外接程序方案的几项功能，对 HwndHost 进行了扩展。下面介绍这些优点和限制。

由于使用从 HwndHost 派生的内部类从宿主应用程序显示 WPF 外接程序 UI，因此，在 WPF UI 服务（如布局、呈现、数据绑定、样式、模板和资源）方面，这些 UI 受到 HwndHost 功能的限制。但是，WPF 扩展了其内部 HwndHost 子类的附加功能，包括：

• 在宿主应用程序的 UI 和外接程序的 UI 之间的 Tab 键切换功能。请注意，不论外接程序是完全受信任还是部分受信任，“外接程序为 UI”编程模型都要求使用外接程序端适配器来重写 QueryContract 以实现 Tab 键切换功能。

• 满足从宿主应用程序 UI 显示的外接程序 UI 的可访问性要求。

• 使 WPF 应用程序可在多个应用程序域方案中安全运行。

• 在外接程序使用安全隔离（即部分信任安全沙盒）运行时，防止非法访问外接程序 UI 窗口句柄。调用 ViewToContractAdapter 以确保安全性：

  • 对于“外接程序返回 UI”编程模型，越过隔离边界传递外接程序 UI 窗口句柄的唯一方法是调用 ViewToContractAdapter。

  • 对于“外接程序为 UI”编程模型，要求对外接程序端适配器重写 QueryContract 并调用 ViewToContractAdapter（如前面几个示例所示），就像从宿主端适配器调用外接程序端适配器的 QueryContract 实现一样。

• 提供多个应用程序域执行保护。由于应用程序域的限制，即使存在隔离边界，外接程序应用程序域中引发的未处理异常也会导致整个应用程序崩溃。但是 WPF 和 .NET Framework 外接程序模型提供了一种简单方法，可以避免此问题，提高应用程序的稳定性。如果宿主应用程序为 WPF 应用程序，则显示 UI 的 WPF 外接程序为应用程序域的运行线程创建一个 Dispatcher。通过处理 WPF 外接程序的 Dispatcher 的 UnhandledException 事件，可以检测应用程序域中引发的所有未处理异常。从 CurrentDispatcher 属性中可以获取 Dispatcher。

对于从宿主应用程序显示的外接程序 UI，除了 WPF 向 HwndSource、HwndHost 和窗口句柄所提供的默认行为增加的优点之外，也存在一些限制：

• 从宿主应用程序显示的外接程序 UI 不遵从宿主应用程序的剪辑行为。

• 互操作性方案中的“空域”概念也适用于外接程序（请参见 WPF 互操作：“空域”和 Window 区域概述）。

• 宿主应用程序的 UI 服务（如资源继承、数据绑定和命令设置）不会自动提供给外接程序 UI。若要向外接程序提供这些服务，需要更新管线。

• 外接程序 UI 不能旋转、缩放、扭曲，也不受变换的影响（请参见变换概述）。

• 通过 System.Drawing 命名空间的绘图操作呈现的外接程序 UI 中的内容可以包含 Alpha 混合。但是，包含它的外接程序 UI 和宿主应用程序 UI 都必须是 100% 透明；换言之，二者的 Opacity 属性都必须设置为 1。

• 如果包含外接程序 UI 的宿主应用程序的窗口的 AllowsTransparency 属性设置为 true，则外接程序不可见。即使外接程序 UI 为 100% 透明（即 Opacity 属性的值为 1）也是如此。

• 外接程序 UI 必须出现在同一顶级窗口中其他 WPF 元素之上。

• 外接程序 UI 的任何部分都不能使用 VisualBrush 呈现。外接程序可以获取生成的 UI 的快照，从而创建一个位图，通过协定所定义的方法可将该位图传递到宿主应用程序。

• 外接程序 UI 的 MediaElement 不能播放媒体文件。

• 宿主应用程序既不会接收，也不会引发为外接程序 UI 生成的鼠标事件，宿主应用程序 UI 的 IsMouseOver 属性值为 false。

• 当焦点在外接程序 UI 的控件之间转移时，宿主应用程序既不会接收，也不会引发 GotFocus 和 LostFocus 事件。

• 在打印时，包含外接程序 UI 的宿主应用程序部分将显示为空白。

• 在所有者外接程序卸载之前，如果宿主应用程序继续执行，则必须手动关闭由外接程序 UI 创建的所有调度程序（请参见 Dispatcher）。协定可以实现一些方法，宿主应用程序使用这些方法，可以在外接程序卸载之前通知外接程序，从而允许外接程序 UI 关闭自己的调度程序。

• 如果外接程序 UI 是 InkCanvas 或包含 InkCanvas，则不能卸载该外接程序。

默认情况下，如果使用多个应用程序域，则每个应用程序所需的所有 .NET Framework 程序集都会加载到该应用程序的域中。因此，创建新应用程序域和在应用程序域中启动应用程序所需的时间可能会影响性能。.NET Framework 提供了一种减少启动时间的方法，即指示应用程序共享各应用程序域的程序集（如果已经加载）。为此，可以使用 LoaderOptimizationAttribute 属性，该属性必须应用于入口点方法 (Main)。这种情况下，只能使用代码来实现应用程序定义（请参见应用程序管理概述）。

下面各个示例（前面已讨论过）演示 LoaderOptimizationAttribute 的用法。

• 外接程序返回 UI 示例。

• 外接程序是 UI 示例。

• 具有多个 UI 的外接程序示例。

任务

概念

参考

其他资源