Share via

OFFICE Web 加载项的 VSTO 外接程序开发人员指南

  • 项目

因此，你已经为在 Windows 上运行的 Office 应用程序制作了一些 VSTO 加载项，现在你正在探索扩展将在 Windows、Mac 和 Office 套件的 Web 浏览器版本上运行的 Office 的新方法：Office Web 外接程序。

重要

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

对 Excel、Word 和其他 Office 应用程序的对象模型的理解将非常有用，因为 Office Web 加载项中的对象模型遵循类似的模式。 但是将面临一些挑战：

  • 你将使用其他语言 (JavaScript 或 TypeScript) ，而不是 C# 或 Visual Basic .NET。 (还有一种方法（稍后将介绍）在 Web 加载项中重复使用某些现有代码。)
  • Office Web 加载项的部署方式不同于 VSTO 加载项。
  • Office Web 外接程序是在 Office 应用程序中嵌入的简化 Web 视图控件中运行的 Web 应用程序，因此需要基本了解 Web 应用程序及其在 Web 服务器或云帐户上的托管方式。

出于这些原因，本文的大部分内容都复制了 Office 扩展初学者指南。 我们添加了一些学习资源，可帮助 VSTO 外接程序开发人员利用其体验，并帮助他们重用其现有代码。

步骤 0：先决条件

  • Office Web 加载项（也称为 Office 加载项）本质上是嵌入在 Office 中的 Web 应用程序。 因此，应首先基本了解 Web 应用程序及其在 Web 上的托管方式。 Internet、书籍和在线课程提供了有关它的大量信息。 如果之前根本不了解 Web 应用程序，一个很好的开始方法是在搜索引擎中搜索“什么是 Web 应用？”
  • 创建 Office 加载项将使用的主要编程语言是 JavaScript 或 TypeScript。 如果你不熟悉其中任一语言，但有使用 VBA、VB.NET、C# 的经验，你可能会发现 TypeScript 更易于学习。 此外，Internet、书籍和在线课程提供了有关这些语言的大量信息。

步骤 1：从基础知识开始

我们知道你渴望开始编码，但是在打开 IDE 或代码编辑器之前，你应该先阅读一些有关 Office 加载项的信息。

  • Office 加载项平台概述：了解什么是 Office Web 加载项以及它们与扩展 Office（如 VSTO 加载项）的旧方法有何区别。
  • 开发 Office 加载项：获取 Office 加载项的开发和生命周期概述，包括工具、创建加载项 UI 以及使用 JavaScript API 与 Office 文档交互。

这些文章中有许多链接，但是如果你正在过渡至 Office Web 加载项的初学者，我们建议你在阅读完后返回此处并继续下一部分。

步骤 2：安装工具并创建首个加载项

现在，你已有了大致的了解，下面需要深入了解其中一个快速入门。 出于学习平台的目的，我们推荐使用 Excel 快速入门。 一个版本基于 Visual Studio，另一个版本基于 Node.js 和 Visual Studio Code。 如果正在从 VSTO 加载项转换，可能会发现 Visual Studio 版本更易于使用。

步骤 3：代码

你无法通过阅读车主手册学会开车，因此请从此 Excel 教程开始编码吧。 你将使用 Office JavaScript 库和加载项清单中的一些 XML。 无需记住任何内容，因为在后面的步骤中，你将获得关于这两者的更多背景知识。

步骤 4：了解 JavaScript 库

通过 Microsoft Learn 培训中的 了解 Office JavaScript API 教程获取 Office JavaScript 库的大图。

然后，使用 Script Lab 工具（用于运行和浏览 API 的沙盒）浏览 Office JavaScript API。

适用于 VSTO 加载项开发人员的特殊支援

这里将介绍如何查看示例加载项、Excel 加载项 JavaScript SalesTracker。 创建的目的是为了突出显示 VSTO 加载项和 Office Web 加载项之间的异同，并且示例的自述文件指出了比较的重点。

步骤 5：了解清单

了解 Web 外接程序清单的用途以及 Office 外接程序清单中的 XML 标记或 JSON 简介。

步骤 6（仅适用于 VSTO 开发人员）：重复使用 VSTO 代码

可以在 Office Web 加载项中重复使用某些 VSTO 加载项代码，方法是将其移到服务器上 Web 应用程序的后端，然后将其作为 Web API 供 JavaScript 或 TypeScript 使用。 有关指南，参见 教程：使用共享代码库在 VSTO 加载项与 Office 加载项之间共享代码。

后续步骤

恭喜你完成了 VSTO 加载项的 Office Web 加载项学习之路！ 以下是进一步探索我们的文档的一些建议：