确认 Office 加载项与已有的COM 加载项兼容

项目
07/07/2023

如果你有现有的 COM 加载项，则可以在 Office 外接程序中生成等效功能，从而使解决方案能够在其他平台（如 Office web 版或 Mac）上运行。在某些情况下，Office 外接程序可能无法提供相应 COM 加载项中提供的所有功能。在这些情况下，COM 加载项在 Windows 上提供的用户体验可能比相应的 Office 外接程序提供更好的体验。

重要

当前处于预览状态的新 Outlook on Windows 不支持 COM 和 VSTO 加载项。经典 Outlook on Windows 桌面客户端仍支持这些加载项。若要了解详细信息，请参阅开发适用于 Windows 上的新 Outlook 的 Outlook 加载项 (预览版) 。

你可以配置 Office 加载项，以便在用户的计算机上安装等效的 COM 加载项时，Windows 上的 Office 将运行 COM 加载项而不是 Office 加载项。 COM 加载项称为“等效”，因为 Office 将在 COM 加载项和 Office 外接程序之间无缝转换，根据该加载项安装在用户的计算机上。

重要

以下平台和应用程序支持等效的外接程序功能。 COM 加载项不能安装在任何其他平台上，因此，在这些平台上， EquivalentAddins将忽略本文稍后讨论的清单元素。

Windows (版本 1904 或更高版本的 Excel、Word和 PowerPoint)
Windows 版 Outlook (版本 2102 或更高版本) 支持的 Exchange 服务器版本
- Exchange Online
- Exchange 2019 累积更新 10 或更高版本 (KB5003612)
- Exchange 2016 累积更新 21 或更高版本 (KB5003611)

指定等效的 COM 加载项

清单

重要

适用于 Excel、Outlook、PowerPoint 和 Word。

若要启用 Office 外接程序和 COM 加载项之间的兼容性，请在 Office 外接程序清单中标识等效的 COM 加载项。然后，Windows 上的 Office 将使用 COM 加载项而不是 Office 加载项（如果两者都已安装）。

以下示例演示清单中将 COM 加载项指定为等效加载项的部分。元素的值 ProgId 标识 COM 加载项，而 EquivalentAddins 元素必须紧靠在结束 VersionOverrides 标记之前。

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

提示

有关 COM 加载项和 XLL UDF 兼容性的信息，请参阅使自定义函数与 XLL 用户定义函数兼容。不适用于 Outlook。

组策略

重要

仅适用于 Outlook。

若要声明 Outlook Web 外接程序与 COM/VSTO 外接程序之间的兼容性，请在组策略中标识等效的 COM 加载项 停用其等效 COM 或 VSTO 加载项的 Outlook Web 外接程序 ，方法是在用户的计算机上对其进行配置。然后，Outlook on Windows 将使用 COM 加载项而不是 Web 加载项（如果两者都已安装）。

下载最新的管理模板工具，并注意该工具的 安装说明。
打开“本地组策略编辑器”(gpedit.msc)。
导航到用户配置>管理模板>Microsoft Outlook 2016>Miscellaneous。
选择设置 停用安装了等效 COM 或 VSTO 加载项的 Outlook Web 外接程序。
打开链接以编辑策略设置。
在要 停用的 Outlook Web 加载项对话框中：
1. 将 “值名称 ”设置为 Id 在 Web 外接程序清单中找到的。 重要提示：不要在条目周围添加大括号 {} 。
2. 将 “值 ”设置为 ProgId 等效 COM/VSTO 外接程序的。
3. 选择 “确定” ，使更新生效。

用户的等效行为

指定等效的 COM 加载项后，如果安装了等效的 COM 加载项，Windows 上的 Office 将不会显示 Office 外接程序的用户界面 (UI) 。 Office 仅隐藏 Office 加载项的功能区按钮，不会阻止安装。因此，Office 加载项仍会显示在 UI 中的以下位置。

在 “我的加载项”下。
作为功能区管理器 (Excel 的条目，Word和 PowerPoint 仅) 。

注意

在清单中指定等效的 COM 加载项对其他平台（如 Office web 版或 Mac）没有任何影响。

以下方案描述了根据用户获取 Office 加载项的方式会发生什么情况。

AppSource 获取 Office 加载项

如果用户从 AppSource 获取 Office 加载项，并且已安装等效的 COM 加载项，则 Office 将：

安装 Office 加载项。
隐藏功能区上的 Office 外接程序 UI。
为指出 COM 加载项功能区按钮的用户显示标注。

Office 加载项的集中部署

如果管理员使用集中部署将 Office 外接程序部署到其租户，并且已安装等效的 COM 加载项，则用户必须先重启 Office，然后才能看到任何更改。 Office 重启后，它将：

安装 Office 加载项。
隐藏功能区上的 Office 外接程序 UI。
为指出 COM 加载项功能区按钮的用户显示标注。

与嵌入式 Office 加载项共享的文档

如果用户已安装 COM 加载项，然后获取包含嵌入式 Office 外接程序的共享文档，则当他们打开文档时，Office 将：

提示用户信任 Office 加载项。
如果受信任，将安装 Office 加载项。
隐藏功能区上的 Office 外接程序 UI。

其他 COM 加载项行为

Excel、PowerPoint、Word

如果用户卸载等效的 COM 加载项，则 Windows 上的 Office 将还原 Office 外接程序 UI。

为 Office 外接程序指定等效的 COM 加载项后，Office 将停止处理 Office 外接程序的更新。若要获取 Office 外接程序的最新更新，用户必须先卸载 COM 加载项。

Outlook

在 Outlook 启动时，必须连接 COM/VSTO 加载项，才能禁用相应的 Web 加载项。

如果随后在后续 Outlook 会话期间断开 COM/VSTO 加载项的连接，则 Web 加载项可能会一直处于禁用状态，直到重新启动 Outlook。

另请参阅

使自定义函数与 XLL 用户定义函数兼容