生成 Excel 内容加载项

项目
06/26/2024

在本文中，你将逐步完成使用 Visual Studio 生成 Excel 内容加载项的过程。

创建加载项

先决条件

已安装 Office/SharePoint 开发 工作负载的 Visual Studio 2019 或更高版本。

注意

如果之前已安装 Visual Studio，请使用 Visual Studio 安装程序，以确保安装 Office/SharePoint 开发 工作负载。
已连接到 Microsoft 365 订阅的 Office (包括 Office 网页版)。

创建加载项项目

在 Visual Studio 中，选择“新建项目”。
使用搜索框，输入“加载项”。选择“Excel Web 加载项”，然后选择“下一步”。
命名项目为 ExcelWebAddIn1 并选择“创建”。
在 “创建 Office 外接程序 ”对话框窗口中，选择“ 将内容插入 Excel 电子表格 ”加载项类型，然后选择“ 下一步”。
选择“ 基本加载项” 或 “文档可视化效果外接程序 ”加载项模板，然后选择“ 完成” 以创建项目。
此时，Visual Studio 创建解决方案，且它的两个项目显示在“解决方案资源管理器”中。 Home.html 文件将在 Visual Studio 中打开。

浏览 Visual Studio 解决方案

在用户完成向导后，Visual Studio 会创建一个包含两个项目的解决方案。

Project	说明
加载项项目	仅包含 XML 格式的仅外接程序清单文件，其中包含描述加载项的所有设置。这些设置有助于 Office 应用程序确定应在何时激活加载项，以及应在哪里显示加载项。 Visual Studio 生成了此文件的内容，以便于用户能够立即运行项目并使用外接程序。通过修改 XML 文件随时更改这些设置。
Web 应用项目	包含加载项的内容页，包括开发 Office 感知 HTML 和 JavaScript 页面所需的全部文件和文件引用。开发加载项时，Visual Studio 在本地 IIS 服务器上托管 Web 应用。准备好发布加载项后，需要将此 Web 应用项目部署到 Web 服务器。

更新清单

在 解决方案资源管理器中，转到 ExcelWebAddIn1 加载项项目并打开 ExcelWebAddIn1Manifest 目录。此目录包含清单文件，即 ExcelWebAddIn1.xml。清单文件定义加载项的设置和功能。请参阅上一节探索Visual Studio 解决方案，详细了解由 Visual Studio 解决方案创建的两个项目。
ProviderName 元素具有占位符值。将其替换为你的姓名。
DisplayName 元素的 DefaultValue 属性有占位符。将它替换为“My Office Add-in”。
Description 元素的 DefaultValue 属性有占位符。将其替换为 Excel 的内容加载项。

保存文件。更新后的行应如下面的代码示例所示。

...
<ProviderName>John Doe</ProviderName>
<DefaultLocale>en-US</DefaultLocale>
<!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
<DisplayName DefaultValue="My Office Add-in" />
<Description DefaultValue="A content add-in for Excel."/>
...

试用

使用 Visual Studio，通过按 F5 或选择 “开始” 按钮启动 Excel，以使用电子表格中显示的内容加载项来测试新创建的 Excel 加载项。
确保工作表中有文本，然后选择工作表中包含文本的任何单元格区域。
选择所选模板的选项卡，然后按照说明进行操作。
- 基本加载项
- 文档可视化加载项
- 在内容外接程序中，选择“ 从所选内容中获取数据 ”按钮，从所选区域获取文本。
- 在内容外接程序中，选择“ 插入示例数据 ”按钮，将示例数据添加到工作表并显示可视化效果。