GrapeCity Documents V9.0 新特性

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

V9.0 版本性能改进

作为一款服务器端电子表格引擎，GcExcel 专为速度而生，尤其是在公式计算和大规模数据处理方面。在 V9.0 版本中，我们大幅提升了众多常用操作的性能，包括复制大范围数据、更新图表链接值、处理动态数组公式、查找操作、自动调整大小功能以及导出包含大量数据透视表的工作簿。这些改进使 GcExcel 在企业级工作负载和高容量自动化场景下运行速度更快、效率更高。

快速复制包含复杂公式的大范围数据

MATCH

SUMIFS

multi-cell

减少频繁获取/设置操作的开销

Range.GetValue

Range.SetValue

更快地复制动态数组公式范围

以前复制包含溢出公式的区域会导致重复的内部状态检查。现在，通过新的优化更新机制，复制大型行区域的速度提高了 98%，将原本需要 78 秒的操作缩短到仅 1 秒多一点。

改进混合数据类型下的查找函数性能

XLOOKUP

MATCH

LOOKUP

自动调整性能和内存优化

AutoFit 现在采用更高效的内部策略，在应用于大型 （300×300） 范围时，处理时间缩短了近一半，内存使用量减少了 60% 以上。

[Java] 加快导出包含大量数据透视表的工作簿的速度

对于 Java 开发人员来说，将包含大量数据透视表的 Excel 工作簿导出到 Excel 的速度现在显著提升。一个典型的测试用例表明，导出包含数十个数据透视表的大型文件时，速度提升了 52%（。NET 在这方面无需优化）。

凭借这些改进，GcExcel 9.0 全面提升了性能，使其更加流畅、快速且更具可扩展性，从而使您的应用程序能够更高效地处理更大的工作簿、更多的公式和更繁重的工作负载。以下是这些性能改进的直观展示。

AI 功能：查询、翻译和文本情感分析

GcExcel V9.0 引入了一系列全新的 AI 函数，可将强大的语言模型功能直接集成到类似 Excel 的公式中。这些函数内置了对模型查询、文本翻译和情感分析的支持，开发者现在可以将 AI 驱动的工作流直接集成到计算引擎中，无需单独的批处理作业或粘合脚本。这些函数可用于模板、公式扩展或自动化场景，并由可插拔的请求处理程序提供支持，因此您可以连接到您选择的 AI 提供商。

#BUSY!

#CONNECT!

#VALUE!

#NA!

可插拔 AI 模型请求处理器

新 AI 功能的核心是 IAIModelRequestHandler 接口。GcExcel 并没有内置特定的 AI 供应商，而是将所有模型调用委托给一个全局处理程序：

• .NET:

  Workbook.AIModelRequestHandler

• Java:

  Workbook.setAIModelRequestHandler(...)

OpenAIModelRequestHandler

• 构建并向您选择的 AI API（OpenAI、Azure OpenAI、DeepSeek、Qwen 等）发送请求。
• 管理 API 密钥、端点和模型名称
• 加强安全、日志记录和合规性
• 返回一个

  AIModelResponse

  内容为 JSON 二维数组的对象，该数组可以清晰地映射到单元格中。

//C#

// Configure once for the entire app
Workbook.AIModelRequestHandler =new OpenAIModelRequestHandler("https://api.openai.com/v1", "sk-xxxx", "gpt-4.1");

//Java

Workbook.setAIModelRequestHandler(new OpenAIModelRequestHandler("https://api.openai.com/v1", "sk-xxxx", "gpt-4.1"));

设置完成后，任何工作簿中的所有 AI 公式都会通过此处理程序路由其请求。

AI.QUERY – 从您的网格向模型提问

AI.QUERY

=AI.QUERY(prompt1, [data1], [prompt2], [data2], ...)

• 提示：描述任务或问题的必填文本
• 数据：可选的单元格或范围，作为上下文传递

GcExcel 会将所有提示参数和数据参数合并成一条消息。例如：

=AI.QUERY("evaluate these reviews ", A6:A13, " based on these categories ", B5:C5)

这将生成一个类似于 “根据以下类别 [B5:C5 中的值] 评估 [A6:A13 中的值] ”的提示，并将模型的响应作为溢出范围返回。

//C#

var wb = new Workbook();var ws = wb.Worksheets[0];
ws.Range["A1"].Value = "Country";
ws.Range["A2:A4"].Value = new object[,] { { "China" }, { "USA" }, { "UK" } };
ws.Range["B1"].Value = "What is the capital of country?";
ws.Range["B2"].Formula2 = "=AI.QUERY(B1, A2:A4, \"Only need capital\")";
wb.Calculate();
wb.WaitForCalculationToFinish();

//Java

Workbook wb = new Workbook();IWorksheet ws = wb.getWorksheets().get(0);
ws.getRange("A1").setValue("Country");
ws.getRange("A2:A4").setValue(new Object[][] { { "China" }, { "USA" }, { "UK" } });
ws.getRange("B1").setValue("What is the capital of country?");
ws.getRange("B2").setFormula2("=AI.QUERY(B1,A2:A4,\"Only need capital\")");
wb.calculate();
wb.waitForCalculationToFinish();

AI.TRANSLATE – 将范围翻译成目标语言

AI.TRANSLATE

句法

=AI.TRANSLATE(array, language)

• 数组：需要翻译的范围或数组
• 语言：必需的语言标识符（例如 en-US、zh-CN、ja-JP 等区域设置名称，或 English、Chinese 等明确的语言名称）

=AI.TRANSLATE(A6, B6)

这将把 A6 中的值翻译成 B6 中指定的目标语言（简体中文），并将结果输出到相应的输出范围。

//C#

var wb = new Workbook();var ws = wb.Worksheets[0];
ws.Range["A1"].Value = "Country";
ws.Range["B1"].Value = "Translation";
ws.Range["A2:A4"].Value = new object[,] { { "China" }, { "USA" }, { "UK" } };
ws.Range["B2"].Formula2 = "=AI.TRANSLATE(A2:A4, \"zh-cn\")";
wb.Calculate();
wb.WaitForCalculationToFinish();

//Java

Workbook wb = new Workbook();IWorksheet ws = wb.getWorksheets().get(0);
ws.getRange("A1").setValue("Country");
ws.getRange("B1").setValue("Translation");
ws.getRange("A2:A4").setValue(new Object[][] { { "China" }, { "USA" }, { "UK" } });
ws.getRange("B2").setFormula2("=AI.TRANSLATE(A2:A4, \"zh-cn\")");
wb.calculate();
wb.waitForCalculationToFinish();

AI.TEXTSENTIMENT – 将文本情感分类为正面/负面/中性

AI.TEXTSENTIMENT 分析文本，并根据情感是积极的、消极的还是中性的返回自定义值。

句法

=AI.TEXTSENTIMENT(array, positive, negative, [neutral])

• 数组：必填输入文本范围
• 正面值：当情绪为正面时返回的值
• 负面：当情绪为负面时要返回的值
• 中性：当情绪为中性时返回的可选值

例子：

=AI.TEXTSENTIMENT(A6:A13, "Positive", "Negative", "Neutral")

GcExcel 将 A6:A13 中的文本发送到您的 AI 处理程序，然后将相应的情感标签写回结果范围。

//C#

var wb = new Workbook();var ws = wb.Worksheets[0];
ws.Range["A1"].Value = "Review";
ws.Range["B1"].Value = "TEXTSENTIMENT";
ws.Range["A2:A6"].Value = new object[,] {
    {"The restaurant offers a beautiful ambiance and attentive service, perfect for family gatherings."}, 
    {"The food is delicious, but the prices are slightly high, which affects the overall value."}, 
    {"It was noisy with poor service and slow food delivery, making for a disappointing experience."},{"Loved the unique dishes and inviting atmosphere！Definitely planning to come back." },{"Great flavors and a cozy setting, although the waiting time was a bit too long." }};
ws.Range["B2"].Formula2 = "=AI.TEXTSENTIMENT(A2:A6, \"Positive\",\"Negative\",\"Neutral\")";
wb.Calculate();
wb.WaitForCalculationToFinish();

//Java

Workbook wb = new Workbook();IWorksheet ws = wb.getWorksheets().get(0);
ws.getRange("A1").setValue("Review");
ws.getRange("B1").setValue("TEXTSENTIMENT");
ws.getRange("A2:A6").setValue(new Object[][] {{"The restaurant offers a beautiful ambiance and attentive service, perfect for family gatherings."},{"The food is delicious, but the prices are slightly high, which affects the overall value."},{"It was noisy with poor service and slow food delivery, making for a disappointing experience."},{"Loved the unique dishes and inviting atmosphere！Definitely planning to come back." },{"Great flavors and a cozy setting, although the waiting time was a bit too long." }});
ws.getRange("B2").setFormula2("=AI.TEXTSENTIMENT(A2:A6, \"Positive\",\"Negative\",\"Neutral\")");
wb.calculate();

IAIModelRequestHandler

新增文本转换函数：VALUETOTEXT 和 ARRAYTOTEXT

GcExcel V9.0 新增了对两个 Excel 新函数 VALUETOTEXT 和 ARRAYTOTEXT 的支持，使用户能够更轻松地将值和数组转换为文本，同时保持与 Excel 行为的完全兼容性。当需要将混合数据类型（数字、布尔值、错误、文本）规范化为字符串，以便进行字符串连接、日志记录、审计或动态公式生成时，这些函数尤其有用。

这两个函数都支持 format 参数，用于控制结果是易于理解的简洁表示，还是带有引号和转义字符的更严格的、与公式栏兼容的字符串。

VALUETOTEXT – 将任何值转换为其文本表示形式

VALUETOTEXT

句法

=VALUETOTEXT(value, [format])

• 值 – 必填。可以是数字、文本、布尔值、错误、空单元格、数组、LAMBDA 函数或范围引用。
• 格式（可选）。

  - 0（默认）：简洁格式，与单元格在“常规”下的显示方式一致。
  - 1：严格格式，适用于公式栏解析。文本用引号括起来，内部引号已转义。

例如：

• =VALUETOTEXT(A2, 0)

  → 你好

• =VALUETOTEXT(A2, 1)

  → “你好”

//C#

Workbook wb = new Workbook();IWorksheet activeSheet = wb.ActiveSheet;
activeSheet.Range["A1:E1"].Value = new object[] { "0", "1", 2, 3, 4 };
activeSheet.Range["A3"].Formula2 = "VALUETOTEXT(A1:E1)"; // "0","1","2","3","4"
activeSheet.Range["A3"].Formula2 = "VALUETOTEXT(A1:E1,1)"; // "\"0\"","\"1\"","2","3","4"
activeSheet.Range["A4"].Formula2 = "ValueToText(A1:E1,\"\")"; // #VALUE!, #VALUE!, #VALUE!, #VALUE!, #VALUE!

false#VALUE!

10/0

value

format

ARRAYTOTEXT – 将数组和范围转换为文本字符串

ARRAYTOTEXT 将整个数组或范围转换为单个文本字符串。

句法

=ARRAYTOTEXT(array, [format])

• 数组 – 必填。要转换的范围或数组。
• 格式（可选）。

  - 0（默认）：简洁格式，与通用显示相匹配。
  - 1：使用行分隔符和引号的严格格式，以便可以将结果作为数组字面量粘贴回公式栏（例如 {200；"Tom";;""}) 。

例如：

• =ARRAYTOTEXT(A2, 0)

  → 真

• =ARRAYTOTEXT(A2, 1)

  → {TRUE}

• =ARRAYTOTEXT(A5, 1)

  → {"你好"}

ARRAYTOTEXT

Sheet2:Sheet3!A1:C3

#VALUE!

#VALUE!

//C#

var workbook = new Workbook(); 
IWorksheet activeSheet = workbook.ActiveSheet;
sheet.Range["A1"].Value = 200;
sheet.Range["A2"].Value = "Tom";
sheet.Range["A4"].Value = "";
sheet.Range["C2"].Formula2 = "=ARRAYTOTEXT(A1:A4,1)"; // {200;"Tom";;""}

GcExcel .NET 和 Java V9.0.0 现在支持 VALUETOTEXT 和 ARRAYTOTEXT，您可以构建更强大的文本处理和检查工作流，同时与现代 Excel 函数行为完全保持一致，无需新的 API 调用。

控制 XLSX 文件中的共享公式导出

GcExcel V9.0 版本引入了一个新选项，使开发人员能够完全控制公式在导出的 XLSX 文件中的写入方式。对于将 GcExcel 与外部 Excel 处理库（例如 Python 的 openpyxl）混合使用的工作流程而言，此增强功能尤为重要，因为 openpyxl 对 Excel 共享公式结构的支持有限。

共享公式是 Excel 的一种节省空间的机制，它允许将重复的公式存储一次，并在多个单元格中应用。虽然这种方式很高效，但某些第三方工具无法正确解析共享公式，导致公式在后续处理过程中丢失或被错误读取。为了解决这个问题，GcExcel 现在提供了一种导出单个公式而非共享公式的方法。

XlsxSaveOptions.ExportSharedFormula

//C#

var workbook = new Workbook();var sheet = workbook.ActiveSheet;
sheet.Range["B1:B10"].Formula = "=A1";var options = new XlsxSaveOptions { ExportSharedFormula = false };
workbook.Save("testNoSharedFormula.xlsx", options);

//Java

Workbook workbook = new Workbook();IWorksheet sheet = workbook.getActiveSheet();
sheet.getRange("B1:B10").setFormula("=A1");XlsxSaveOptions options = new XlsxSaveOptions();
options.setExportSharedFormula(false);
workbook.save("testNoSharedFormula.xlsx", options);

通过此次更新，GcExcel V9.0 可以更轻松地在混合技术栈中集成 Excel 自动化，同时可靠地保持公式行为。

为 SpreadJS 报表表保留“显示隐藏的行和列”选项

在许多 SpreadJS 报表设计场景中，设计人员希望在设计模板时，某些行和列虽然在最终报表中技术上是隐藏的，但仍然可见且可编辑。SpreadJS 通过在编辑器中显示隐藏的行和列，并在预览/运行时才将其隐藏，从而支持这种设计时体验。在 GcExcel V9.0 中，我们增强了与 SpreadJS 的集成，以便在服务器上处理 SJS/SSJSON 文件时，也能始终保持这种行为。

GcExcel 现在为使用“设计时显示隐藏行和列”行为的报表表模板提供无损的 SJS/SSJSON I/O 功能。打开 SJS 或 SSJSON 文件时，所有与隐藏行和列相关的报表表配置都会被保留。保存或转换工作簿时，这些设置会原封不动地写入，确保 SpreadJS UI 中的设计时可见性功能继续按预期工作。

//C#

var workbook = new Workbook();
workbook.Open("HiddenRowsColumns.sjs");using (var fs = File.Create("export.json")){
workbook.ToJson(fs);} // End Using
workbook.Save("export.sjs");

//Java

workbook = new Workbook();
workbook.open("HiddenRowsColumns.sjs");
workbook.toJson(new FileOutputStream("exportJava.json"));
workbook.save("exportJava.sjs");

通过此次更新，GcExcel 。NET 和 Java V9.0 可以更好地与 SpreadJS ReportSheet 的设计时体验保持一致，同时在预览或运行时仍能提供准确的隐藏行/列行为。

无损保存 Excel Power Query 表

Power Query 是现代 Excel 报表功能的核心组成部分，它允许用户将数据库、文件、Web API 和其他外部来源的数据加载到表格、数据透视表和图表中。在之前的版本中，当包含查询表和外部数据连接的工作簿通过 GcExcel 打开和保存时，底层与查询相关的 XML 部分不会被保留。这意味着，经过 GcExcel 的往返转换后，Power Query 表在 Excel 中可能会丢失其刷新功能和元数据。

/xl/queryTables/queryTableX.xml

此增强功能专为数据保存而设计，而非编辑。GcExcel 不会尝试解释或修改查询定义；它只是在 XLSX 打开/保存操作中原封不动地保留查询定义。通过此更改，GcExcel 。NET 和 Java V9.0.0 可以安全地参与依赖于 Excel Power Query 的工作流，同时保留原始工作簿中的所有查询定义和外部数据连接。