Excel 加载项中的数据类型概述

数据类型将复杂的数据结构组织为对象。 这包括格式化数字值、Web 图像和实体作为 实体卡。

以下屏幕截图突出显示了数据类型的主要功能之一：实体卡。 在这种情况下，实体卡从杂货店产品列表中显示有关豆腐产品的扩展信息。

注意

若要立即开始试验数据类型，请在 Excel 中安装Script Lab，并检查示例库中的“数据类型”部分。 还可以浏览 OfficeDev/office-js-snippets 存储库中的Script Lab示例。

在添加数据类型之前，Excel JavaScript API 已支持字符串、数字、布尔值和错误数据类型。 Excel UI 格式设置层能够向包含四种原始数据类型的单元格添加货币、日期和其他类型的格式设置，但此格式设置层仅控制 Excel UI 中原始数据类型的显示。 即使 Excel UI 中的单元格设置为货币或日期格式，基础数字值也不会更改。 基础值与 Excel UI 中带格式的显示之间的这一差距可能导致加载项计算过程中出现混淆和错误。 数据类型 API 是解决此差距的一个解决方案。

数据类型将 Excel JavaScript API 支持扩展到四种原始数据类型 (字符串、数字、布尔值和错误) ，以将 Web 图像、 格式化数字值、 实体、实体中的数组以及改进 的错误数据类型 作为灵活的数据结构包括在内。 这些类型支持许多 链接数据类型 体验，在加载项计算过程中实现了精确和简化，并将 Excel 加载项的潜力扩展到 2 维网格之外。

提示

在以下示例工作簿中查看所有 Excel 用户可用的 链接数据类型示例： linked-data-types-sample-workbook.xlsx。

资源

使用以下资源浏览数据类型。

1. 在 Excel 数据类型核心概念 一文中了解数据类型基础知识。
2. 在 Excel 中安装Script Lab，并浏览示例库中的“数据类型”部分。
3. 在将 卡片与实体值 数据类型配合使用一文中，了解如何将 Excel 扩展到具有实体数据类型的 2 维网格之外。
4. 请尝试 OfficeDev/Office-Add-in-samples 存储库中的“在 Excel 中创建和浏览数据类型”示例。

数据类型和自定义函数

数据类型增强了自定义函数的功能。 自定义函数接受数据类型作为自定义函数的输入和自定义函数的输出，并且自定义函数对数据类型使用与 Excel JavaScript API 相同的 JSON 架构。 在自定义函数计算和求值时，对此数据类型 JSON 架构进行维护。 如果要详细了解如何将数据类型与自定义函数集成，请参阅自定义函数和数据类型。