GrapeCity Documents V8.0 Update2 新特性

服务端表格组件 GrapeCity Documents for Excel 更新说明

1、性能飙升：三大场景效率翻倍

针对企业级应用中“大文件加载慢、公式计算卡、内存占用高”的痛点，GcExcel 进行专项优化，实测数据表现亮眼：

（1）公式计算速度提升 30%+

聚焦开发者高频使用的查找类、统计类、动态数组函数，优化计算逻辑：

• 查找函数：VLOOKUP、XLOOKUP、HLOOKUP、MATCH 等在百万级数据区域中搜索速度提升 30%；
• 统计函数：POISSON.DIST（泊松分布）计算时间降低 83.96%，COMBIN（组合数）降低 70.46%，AVERAGEIF、COUNTIF 提升 50%+；
• 动态数组函数：UNIQUE（去重）、SORT（排序）内存占用减少 40%，避免大数组计算导致的内存溢出。

（2）海量自定义名称文件操作提速 50%

财务报表、ERP 系统生成的 Excel 模板常包含数万自定义名称，此前加载时检索耗时占比高达 38%。V8.0 Update2 优化存储与检索逻辑：

• 打开/保存含 14.4 万个自定义名称的文件时，速度提升超 50%；
• 检索耗时占比骤降至 1%，彻底解决大文件加载卡顿问题。

（3）模板数据处理内存优化 25%

针对使用 ITableDataSource 加载海量数据的模板场景（如 BI 报表、批量账单生成），通过内存复用机制：

• 内存占用降低 25%，减少服务器资源消耗；
• 避免频繁 GC（垃圾回收）导致的应用卡顿，支持更长时间的批量处理任务。

2、公式功能升级：动态数组与高阶函数全覆盖

（1）新增 4 大高频函数，简化数据处理

针对“分组聚合、数据清洗”等高频场景，新增 4 个实用函数，无需复杂嵌套即可完成复杂计算：

函数名称	核心功能	应用场景
GROUPBY	单维度分组聚合，支持排序、筛选	按“地区”汇总销售数据、按“部门”统计员工绩效
PIVOTBY	双维度交叉分组（类似数据透视表）	按“地区+产品类别”交叉汇总销量、按“年份+季度”统计营收
PERCENTOF	计算子集占总体的百分比	统计某产品销量占地区总销量比例、某部门成本占公司总成本比重
TRIMRANGE	自动移除数据区域的空行/空列	清洗 ERP 导出的含空行原始数据、规整用户录入的杂乱表格

示例：用 GROUPBY 按年份汇总产品销量

（2）简化 Lambda 写法，代码更简洁

Lambda 函数是动态数组的核心，但传统写法需完整包裹（如

BYROW(A1:A10, LAMBDA(a, ABS(a)))

），冗长且易出错。V8.0 Update2 支持 Eta-reduced Lambda，可直接传递函数名作为参数：

• 简化前：

  =BYROW(A1:A5, LAMBDA(x, SUM(x)))

• 简化后：

  =BYROW(A1:A5, SUM)

代码量减少 40%，可读性与维护性大幅提升。

（3）Evaluate2 方法：完整获取动态数组结果

此前

Evaluate

方法仅返回单个值，无法处理动态数组“溢出”（Spill）结果。新增

IWorksheet.Evaluate2

方法，可完整获取数组公式的所有结果，完美适配 Excel 2021/365 特性：

    
// Java 示例：计算产品名称长度并写入单元格
Workbook workbook = new Workbook();
IWorksheet sheet = workbook.getWorksheets().get(0);
// 初始化产品数据
sheet.getRange("B4:B11").setValue(new String[]{"Apple", "Grape", "Pear", "Banana", "Coconut", "Strawberry", "Mango", "Pineapple"});
// Evaluate2 获取所有名称长度（返回数组）
Object evaluateRes = sheet.evaluate2("=LEN(B4:B11)");
// 将结果写入 D 列
sheet.getRange("D4:D11").setValue(evaluateRes);
workbook.save("产品名称长度分析.xlsx");
    

3、可视化与交互优化：图表适配与无障碍支持

（1）图表 Sheet 自适应选区缩放

传统图表 Sheet 需手动调整缩放比例以适配窗口，V8.0 Update2 通过

IWorksheetView.FitSelection

属性实现程序化自适应：

// C# 示例：设置图表自适应显示
worksheet.View.FitSelection = true;

自动化报表系统（如财务月报、销售周报）生成的图表可自动填满显示区域，避免因设备分辨率不同导致的内容截断。

（2）形状无障碍支持：符合企业合规要求

为满足政府、金融等行业的无障碍办公需求，新增“替代文本”与“装饰标记”功能，支持屏幕阅读器识别视觉元素：

• IShape.AlternativeText

  ：为图表、图片设置描述文本（如“2024 Q1 销售趋势图”）；

• IShape.Decorative

  ：标记形状为“纯装饰性”（如背景花纹），屏幕阅读器会自动跳过。

// Java 示例：为柱状图设置无障碍属性
IShape chart = worksheet.Shapes.AddChart(ChartType.ColumnClustered, 100, 100, 400, 300);
// 屏幕阅读器读取的描述文本
chart.setAlternativeText("2024年各地区销售对比柱状图，华北地区销量最高");
// 标记为非装饰性（重要内容）
chart.setDecorative(false);        

（3）工作表背景图全流程兼容

支持读取和导出 SpreadJS（葡萄城前端表格控件）的工作表背景图（Base64 格式），并可导出至 PDF（需设置

PdfSaveOptions.PrintBackgroundPicture = true

），实现“前端编辑-后端处理-PDF 导出”的背景图一致性，解决此前前后端视觉差异问题。

4、开发者体验增强：错误处理与日志监控

（1）自定义函数错误值处理

此前自定义函数若传入错误值（如 #DIV/0!、#VALUE!）会直接中断公式。新增

CustomFunction.AcceptErrors

属性，支持主动接收错误值并自定义处理（如日志记录、返回默认值）：

    
// Java 示例：自定义函数处理错误值
Workbook workbook = new Workbook();
// 注册支持错误处理的自定义函数
workbook.addCustomFunction(new MyFunctionWithAcceptErrors("MyFuncCanAcceptErrors", true));
// 传入错误值（1/0 会返回 #DIV/0!）
worksheet.getRange("B3").setFormula("=MyFuncCanAcceptErrors(1, 2, 1/0)");
// 函数内可捕获错误并返回提示："Exist errors: #Div0"
    

（2）Java 端日志监控（基于 Apache Commons Logging）

新增可配置日志系统，支持集成 Log4j、Logback 等主流日志组件，实时监控 GcExcel 运行状态：

• 日志级别：DEBUG（调试）、INFO（信息）、WARN（警告）、ERROR（错误）；
• 监控内容：文件加载进度、公式计算耗时、PDF 分页信息等，快速定位线上问题。

日志示例：

 

DataTemplate.GetTemplateTagInfos() 

{{CustomerName}} {{OrderAmount}}

TemplateTagInfo

WordLayoutSettings.MarkTemplateTagAreas = true

PdfOutputSettings.MarkupTemplateTags