支持 .NET 5 和 .NET Core 3.1

Spread .NET V14.0 提供了一个用于 .NET 5 和 .NET Core 3.1 WinForms 开发环境的 NuGet 程序包。

使用这个新程序包，就可以在 .NET 5 和 .NET Core 3.1 中使用 Spread 表格控件创建 WinForms 应用程序，并使用 GrapeCity Spread .NET 控件移植现有的 WinForms 项目。

单元格类型增强，可以将 .NET 对象作为自定义单元格类型

单元格类型增强是 Spread .NET 14.0 中的一项主要更新。

借助这一更新，你可以通过自定义数据类，来创建自定义单元格类型，然后使用该类创建对象并将其设置为单元格的值。该对象将使用自定义图像显示在单元格中，并显示该对象的默认属性。

另外，当该单元格处于活动状态时，“插入数据”工具将显示在该单元格旁边（请参见上图的 B12 单元格）。单击“插入数据”工具后，将显示一个弹出列表，列出可在相邻单元格或列中插入的可用数据字段：

单击弹出列表中的字段将自动插入适当的公式，您也可以单击单元格中的标志符号，或在单元格处于活动状态时按 Ctrl + Shift + F5 来显示对象的数据卡片：

要创建这些数据类型，可以为单元格数据类型先定义类，并指定要显示的属性，然后创建这个类的对象实例，并创建 RichValue 来实现 IRichValue 对象。

当然，你也可以直接在单元格数据类型类上实现 IRichValue 并通过接口指定字段（上面示例中的 Vehicle 类就是通过这种方式实现的）。

为了加速创建单元格的自定义数据类型，Spread .NET 实现了内置的类 BuiltInRichValue，可用于将 DataView 或 DataTable 包装在单元格数据类型内，如下图所示：

超链接功能增强

Spread .NET 14.0 增强了超链接功能，包括：

• 链接到单元格引用
• 链接到命名范围
• 链接到tables
• 链接到电子邮件
• 链接到网站和文件
• 从单元格，形状和图像上来链接
• 自定义链接的提示文本
• 编辑单元格时自动创建链接

通过启用 AutoCreateHyperlink 功能，在 Spread .NET 中编辑单元格时可以自动创建超链接，包括使用特殊语法（例如“spread://Sheet1!A1”）指定工作簿内部链接的位置，该语法还支持命名范围（如“spread://SalesSummary”）和表格名（如“spread://Table1”）。

使用 Ctrl + K 调用 “编辑超链接”对话框，就可以修改链接目标，如要显示的文本和屏幕提示文本：

新增 LET 函数，优化计算效率

LET 函数允许您在公式中预定义名称，然后使用这些名称来计算表达式。

例如，一个简单的表达式“SUM(x, 1)”，其中 x 是一个命名参数，可向它赋值（在本例中，x 的赋值为 5）。
=LET(x, 5, SUM(x, 1))
将此公式输出到单元格后，它将返回值 6。

使用此函数，你不必记住特定范围或单元格引用的是什么，也不用关心一个计算做了什么，甚至不必再复制粘贴相同的表达式。

该函数通过消除多余的中间值来优化你的计算速度，中间值仅需计算一次，便可重复使用。

在上面的示例中，左侧的电子表格使用LET 函数来优化计算，其计算结果比不使用 LET 功能并执行相同计算的右侧电子表格快了三倍。

支持移动 Sharp 形状中的点来创建自定义形状

Spread .NET 的形状引擎支持导入和创建 Microsoft Excel 形状。

在新版本中，新增的“编辑点”命令使用户可以自定义形状中的点和线段。右键单击形状，可在上下文菜单中使用“编辑点”命令：

选择任何增强形状时，“编辑点”命令也可在Spread Designer功能区栏中的“编辑形状”菜单里找到：

键盘快捷键增强，可为用户启用与 Excel 完全兼容的键盘快捷键

Spread .NET 14.0可为最终用户启用与 Microsoft Excel 完全兼容的键盘快捷键。

通过将FpSpread.Features.ExcelCompatibleKeyboardShortcuts设置为true，即可加载这些键盘映射，设置 FpSpread.Features.ExcelCompatibleKeyboardShortcuts = false 将删除这些键映射并恢复默认设置：

使用InputMap API创建自定义键映射，可为DisplayFormulas、ShowFormatCellsDialog、ShowCard、ShowHyperlinkDialog和EditMultipleCells这几个新的SpreadAction对象创建自定义快捷方式。

支持如 Excel 相同的多工作表选择功能

Spread .NET 支持像 Microsoft Excel 一样使用Ctrl + 单击工作表选项卡来选择多个工作表。

当多个工作表被选中时，用户可以拖放选定的工作表，并重新排列在工作簿中。如下所示，Sheet1和Sheet3都被移动到工作簿Sheet4之后：

在拖动选定的工作表时按Ctrl键，将复制这些工作表而不是将其移动：

可切换显示公式与计算结果

和 Microsoft Excel 一样，Spread .NET 支持按 Ctrl +` 来切换显示公式本身还是计算结果。

要启用此命令，必须在设计时或代码中将 FpSpread.Features.ExcelCompatibleKeyboardShortcuts 设置为 true，如下图所示：

默认显示计算结果：

点击显示公式：

Spread .NET 在新版本中增强了形状引擎，该引擎与 Microsoft Excel® 100％ 兼容，和此前的形状引擎相比，新引擎与 Excel 的兼容性更高，功能也更完善。

1. 新的形状引擎支持所有 Excel 形状：

（Spread支持所有Excel形状）

2. 新引擎支持多组形状组合，可用于创建图表、结构图和流程图：

（在Spread中创建的流程图示例）

3. 新的形状引擎可用于创建丰富的交互式界面，比如一个汽车保险索赔示例：

（使用 Spread 形状创建的汽车保险索赔示例）

要使用这个形状引擎，可以通过“属性网格”启用它：

（启用形状引擎）

也可以直接通过代码启用：

【C#】

fpSpread1.Features.EnhancedShapeEngine = true;

【VB】

fpSpread1.Features.EnhancedShapeEngine = True

Spread .NET 形状属性的绑定机制在本次发布中得到增强，支持将 AutoShapeType、TextEffect、Fill、Line、Top、Left、Height 和 Width 等属性绑定到特定的单元格中，用来设计更为丰富的交互式界面。同时，利用单元格公式的计算结果，还可以动态更新这些属性。

举例：

在上面的汽车保险索赔示例中，各形状的详细属性在 Sheet2 中如下所示：

（塑造汽车保险索赔示例的属性绑定）

通过代码来绑定形状的属性：

【C#】

 IWorkbook workbook = fpSpread1.AsWorkbook(); IShapes shapes = workbook.Worksheets[0].Shapes; // bind shape properties to cells shapes["Front"].Bindings.Add("Left", "Sheet2!B2"); shapes["Front"].Bindings.Add("Top", "Sheet2!C2"); shapes["Front"].Bindings.Add("Width", "Sheet2!D2"); shapes["Front"].Bindings.Add("Height", "Sheet2!E2"); shapes["Front"].Bindings.Add("Line", "Sheet2!F2"); 

【VB】

 Dim workbook As IWorkbook = fpSpread1.AsWorkbook Dim shapes As IShapes = workbook.Worksheets(0).Shapes   bind shape properties to cells shapes("Front").Bindings.Add("Left", "Sheet2!B2") shapes("Front").Bindings.Add("Top", "Sheet2!C2") shapes(Front").Bindings.Add("Width", "Sheet2!D2") shapes("Front").Bindings.Add("Height", "Sheet2!E2") shapes("Front").Bindings.Add("Line", "Sheet2!F2") 

可通过如下控制面板，启用此功能：

（使用属性面板启用FpSpread.Features.RichClipboard）

或者，您也可以直接在代码中设置：

【C#】

fpSpread1.Features.RichClipboard = true;

【VB】

fpSpread1.Features.RichClipboard = True;

当启用复制粘贴的增强选项时，您可以享受如下功能：

• 向 Excel 复制 Spread 设计器中选定的范围和单元格（包括源格式、公式和值）
• 从 Excel 中粘贴 Shape、Picture、Slicer （包括格式、样式、效果和文本内容）到 Spread 设计器中

您可以直接向 Spread 设计器导入、导出带有切片器的 Excel 文件，也可以直接在 Spread 设计器中插入切片器：

（Spread Designer中的插入切片器）

插入 Spread 切片器时弹出的对话框：

（插入切片器的对话框）

通过代码显示“ 插入切片器”的对话框：

【C#】

 SlicerInsertForm dlg = new SlicerInsertForm(table, new Point(25, 25)); dlg.ShowDialog(this); 

【VB】

 Dim dlg As SlicerInsertForm = new SlicerInsertForm(table, new Point(25, 25)) dlg.ShowDialog(Me) 

Spread切片器的作用与Excel相同，都是用来显示表列中的唯一值，并通过快速筛选整张表来定位该值所在的行：

（Spread为“国家/地区”表列创建的切片器）

Spread .NET 在新版本中新增了一个名为 VisualFunction 的新型自定义计算功能。

使用这个功能，您可以定义一个自定义公式函数，用来在单元格中绘制内容或应用格式，使用此功能在单元格中绘制内容类似于创建迷你图，但比创建迷你图还要简单。

此功能与 Spread 新的计算引擎和新函数类的 VisualFunction 集成在了一起。

举例：

您可以自定义绘制 QR 代码的 VisualFunction：

（显示QR代码的VisualFunction）

在公式中引用 VisualFunction 时，需要在 VisualFunction 的名称前使用前缀“ VF. ” ，并传入参数。

如上面的示例中，VisualFunction QRCODE 接收了两个参数（B1,C1），因此将 B1 到 C1 单元格中 Spread .NET 的网址生成了一个标准 QR 码。

Spread .NET 增强了对 XLOOKUP 和 XMATCH 函数的支持，这些函数目前仅在 Microsoft Excel® 的 Office Insiders 版本中可用。

和旧的 LOOKUP、VLOOKUP、HLOOKUP 和 MATCH 相比，XLOOKUP 和 XMATCH 更好，原因如下：

• XLOOKUP 和 XMATCH 可以执行垂直或水平查找（或在嵌套时都执行），具体取决于 lookup_array 的方向。
• 即使没有对数据进行排序，XLOOKUP 和 XMATCH 仍可以执行具有正确结果的非精确查找（与 HLOOKUP / VLOOKUP / MATCH 不同）。
• XLOOKUP 和 XMATCH 默认执行精确匹配查找（与 LOOKUP / HLOOKUP / VLOOKUP / MATCH 不同）。
• XLOOKUP 不需要引用包含 _ lookup_array _ 和 _ return_array _ 的全部范围，仅需引用特定范围即可。因此就计算效率而言，XLOOKUP 可以比 HLOOKUP / VLOOKUP 更高效。
• 因为使用了范围引用，XLOOKUP 在插入、删除和移动 _ lookup_array _ 或_ return_array _ 的列、行时会自动调整。
• Spread .NET 中对 XLOOKUP 和 XMATCH 进行了增强，支持 _search_mode 0 - All_ （它用来返回数组中的所有匹配项，防止当启用动态数组时，这些项因为溢出到相邻的单元格中而没有被匹配到）。

从上面的最后一点可以看出，启用动态数组功能时，为了避免遗漏数据，需要借助 _ search_mode 0-All _ ，而只有 XLOOKUP 和 XMATCH 才能支持它。

（在Spread功能区中启用“动态数组”）

通过代码启用动态数组：

【C#】

pSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray;

【VB】

fpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray

Spread .NET 加入了公式值自动格式化的功能：

• 使公式函数的运算结果自动匹配当前的单元格样式（类似 Microsoft Excel）。
• 引用其他单元格时，将自动使用所引用单元格的样式。
• 此功能必须启用时才会生效（确保向后兼容）。

Spread .NET 提供的公式值自动格式化功能与 Excel 类似，如使用 DATE 函数计算日期时，计算结果将自动设置为日期格式。

Spread .NET 的公式值自动格式化，可以根据原始单元格格式自动格式化公式值。

举例：

在单元格 A1 中键入 1500.65，然后应用“ 货币”格式，则该单元格将显示为 $ 1500.65。此时，在单元格 A2 中键入公式“= A1”，则单元格 A2 的值也将显示为货币格式。

如果将单元格 A2 的“单元格格式”更改为会计专用，则单元格 A2 中的值将更新为 “ 会计专用格式”而不是“ 货币格式”。

此时，在单元格 B1 中键入公式“= A1”，然后将公式向下拖动到单元格 B2 中，则这两个单元格的格式均为货币类型，因为 B1、B2 单元格均引用自 A1，而 A1 的单元格格式为货币：

（根据引用单元格格式自动格式化公式值）

注：为了向后兼容，此功能默认未启用，使用时必须通过 IWorkbook.Features 来启用：

【C#】

IWorkbook.Features.AutoFormattingworkbook.Features.AutoFormatting = True

【VB】

IWorkbook.Features.AutoFormattingworkbook.Features.AutoFormatting = True

Spread .NET 可以动态调整行标题的大小，当您向下滚动表格时，该行标题会自动调整以显示完整的行号：

（向下滚动时自动调整行标题宽度）

此功能的应用场景是：在数据量非常大的电子表格中，用户向下滚动时可以查看完整的行索引号。

Spread .NET 现在使用新的重载方法 SetBackgroundPicture 在 IWorkbook 界面中为工作簿设置背景图像：

【C#】

 void IWorksheet.SetBackgroundPicture(string filename, [string contentType = null]) void IWorksheet.SetBackgroundPicture(System.IO.Stream imageStream, string contentType) 

【VB】

 Sub SetBackgroundPicture(filename As String, Optional contentType As String = Nothing) Sub SetBackgroundPicture(imageStream As System.IO.Stream, contentType As String) 

 注：背景图片必须从文件或数据流中加载，并且指定的文件类型必须是：

• 图片/ jpeg
• 图片/ png
• 图片/ tiff
• 图片/ gif
• 图片/ Bmp

（编辑公式将结构化引用插入到表格单元格中）

使用 Spread 中的 FormulaTextBox 控件编辑公式时，可以选择单元格、表格列或整个表格，并自动插入结构化引用。

注：这个功能可适用于整个表的列引用和整个表引用，但是对于使用 [@ColumnName] 语法的单元格引用，其引用的单元格必须与表单元格位于同一行中，如果表单元格在另一行中，则只能使用常规单元格引用。

Spread .NET 提供了一个新事件 BeforeRightClick，该事件用于：最终用户右键单击电子表格内部时，可以通过事件、API 来自定义上下文菜单。

您可以在此事件中调用 API（如 FpSpread.HitTest）实现：定位光标下的单击位置和对象，覆盖默认行为，并自定义上下文菜单（包括样式、自定义功能），BeforeRightClick 事件为 Spread 设计器的右键单击操作，带来了更为个性化、更加灵活的功能。

Spread .NET 在本次更新中，加入了一些令人兴奋的新示例，这些示例可以在C＃和VB中运行，并且他们已经包含在 Spread .NET 的安装程序中：

1. 汽车保险索赔示例

汽车保险索赔展示了：如何获取包含 VBA 代码和自定义形状的 Excel 工作簿（* .XLSM），并将其转换为 .NET WinForms 应用程序（Spread 设计器），该应用程序可以将新的命令（包含用户插入的 VBA 宏和其他修改项目）导出至 Excel 中。

2. 动态数组示例

该示例展示了：如何使用 Spread 的动态数组功能，以及使用动态数组的示例。您可以浏览到每个带有新公式函数 FILTER、RANDARRAY、SEQUENCE、SINGLE、SORT、SORTBY 和 UNIQUE 的工作表。

3. 公式跟踪示例

该示例展示：如何使用 Spread 新的 API 跟踪公式的源、从属单元格和引用单元格。

4. 自定义函数功能示例

该示例展示：如何实现返回数组或计算结果的自定义计算函数，该函数可与数组公式或新的动态数组功能（如果已通过 IWorkbookSet.CalculationEngine.CalcFeatures 启用）一起使用。

5. XLOOKUP 和 XMATCH 函数功能示例

该示例展示：如何使用新的 XLOOKUP 和 XMATCH 计算函数以及增强的 search_mode 0_ 来返回数组中的所有匹配项。

6. 自定义数据可视化示例

示例显示了如何创建一个新的 VisualFunction 在单元格内绘制 QR 码。

7. 切片器示例

显示了如何使用 Spread 切片器过滤工作表中的数据，以及如何设置切片器样式。

8. 形状引擎功能示例

显示了如何使用 Spread 的增强形状引擎创建流程图。

Excel 2019 推出了动态数组函数，用于简化复杂计算公式：使用动态数组，返回值将自动“输出”到相邻单元格中（未使用的）。用户只需编写一个简单的公式，而不是编写复杂的数组公式就可解决多单元格问题。

fpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray; 

FpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray 

Spread .NET 设计器（Spread Designer） 中新增了 Formulas选项卡，包含全新的动态数组支持（默认情况下不启用）、定义名称、公式审计和用于计算的工具。

通过创建 IWorkbook，Spread .NET 为所有 GrapeCity.Spreadsheet.IWorkbook API（如 Microsoft Excel® VSTO API）提供了与 VSTO 类似的基于 1 的索引，这样做的目的是：可以轻松地将 Excel VBA 代码或旧的 Spread COM 代码（基于 1 的行和列索引部分）移植到 .NET 平台下（后者曾一直使用基于 0 的索引来支持以前版本中的所有 API，以实现 CLS）。

 IWorkbook iwb = WorkbookSet.CreateBase1Object(fpSpread1.AsWorkbook());

Dim iwb As IWorkbook = WorkbookSet.CreateBase1Object(FpSpread1.AsWorkbook())

Spread .NET 对创建自定义计算功能提供了丰富的支持，如使用AsyncFunction类创建类似RTD函数的异步函数。RTD 函数自 Excel 2002 引入，主要用于查看和更新实时数据。在 Spread .NET V12.1 中，您可以创建继承自 AsyncFunction 的自定义计算函数，实现对异步计算的支持，还可以通过各种 FunctionAttributes 来指示特殊函数的行为，如波动率或返回数组值。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。

如Excel一样，增强颜色筛选用户界面支持按“无填充”进行筛选。为减少具有大量隐藏单元下的视图状态大小，可将新属性 AllowGenerateHiddenData 设置为 false。 此属性比 AllowGetAllHiddenValue 更强大。当其设置为 false 时，表单中的所有隐藏值都保留在服务器端，从而减少视图状态的大小，并提高了页面安全性。在这种情况下，客户端接口 GetHiddenValue 和 GetHiddenCellValue 将不起作用。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。

新增的单元格验证和增强的数据验证，为用户数据输入提供了强大的新选项，并支持在 Excel 文档中保存和加载数据验证。支持了 Excel 中提供的 8 种数据验证类型，包含：任何值、整数、小数、序列、日期、时间和文本长度以及自定义。

新增 130 多个计算公式，使公式总数达到了 462 个。新支持数组公式（使用 Ctrl + Shift + Enter 输入）可以实现高级矩阵和数组计算。当用户输入创建循环引用的公式时，触发新添加的 CircularFormula 事件。

本次增加 spread 所有支持公式一览表。

新增保护工作簿结构功能，并可设置密码。该功能保护工作簿结构并防止用户删除或重新排序工作表。

新增接口来获取和设置文档属性，包含：标题，主题，作者，公司等。

新的增强型 HyperLinkCellType 现在可以很好地处理排序和过滤功能。

支持从行头单元格拖放，即可直接在用户界面中移动行的功能。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。