Documentation – 插入数据透视表

Nodejscpp: 格式化数据透视表

Mon, 01 Jan 0001 00:00:00 +0000

数据透视表外观

如何创建数据透视表介绍了如何创建简单的数据透视表。本文描述了如何通过设置各种属性来自定义数据透视表的外观:

数据透视表格式选项
数据透视字段格式选项
数据字段格式选项

如何设置数据透视表格式选项

PivotTable类控制整体数据透视表，可以以多种方式进行格式设置。

如何设置自动格式类型

微软Excel提供多种预设报告格式。Aspose.Cells for Node.js via C++ 同样支持这些格式。要访问它们：

将PivotTable.setIsAutoFormat(value)设置为true。
从PivotTableAutoFormatType枚举中分配一个格式选项。

如何设置格式选项

下面的代码示例演示了如何格式化数据透视表以显示行和列的总计，以及如何设置报告的字段顺序。它还显示了如何为空值设置自定义字符串。

手动设置外观和感觉格式

要手动设置数据透视表报告的外观和感觉，而不是使用预设的报告格式，请使用PivotTable.formatAll(style)和PivotTable.format(row, column, style)方法。为所需的格式创建样式对象，例如：

如何设置数据透视表字段格式选项

PivotField类表示数据透视表中的字段，并可以以多种方式进行格式设置。下面的代码示例演示了如何:

访问行字段。
设置合计。
设置自动排序。
设置自动显示。

如何设置行/列/页面字段格式

如何设置数据字段格式

以下代码示例显示如何设置数据字段的显示格式和数字格式。

如何清除数据透视字段

PivotFieldCollection 有一个名为 clear() 的方法，允许您清除数据透视字段。当您想要清除区域中的所有数据透视字段时（例如页、列、行或数据），请使用它。以下代码示例显示如何清除数据区域中的所有数据透视字段。

Nodejscpp: 创建数据透视表和数据透视图

Mon, 01 Jan 0001 00:00:00 +0000

数据透视表是记录的互动摘要。例如，您可能有数百个工作表中列表中的发票条目。数据透视表可以按客户、产品或日期总计发票。使用Microsoft Excel，可以通过将按钮拖到新位置，快速重新排列数据透视表中的信息。

数据透视图图表是数据透视表中数据的交互式图形表示。数据透视图图表在Excel 2000中引入。使用数据透视图图表使数据更容易理解，因为数据透视表会自动创建小计和总计。

Aspose.Cells for Node.js via C++ 支持数据透视表和数据透视图。

使用Aspose.Cells for Node.js via C++添加数据透视表和图表

Aspose.Cells for Node.js via C++ 提供了一组用于创建数据透视表的特殊类。这些类用于创建和设置数据透视表对象，它们作为数据透视表对象的基本构建块：

PivotField，数据透视表报告中的字段。
PivotFields，数据透视表中所有 PivotField 对象的集合。
一个工作表上的数据透视表。
数据透视表是工作表上所有数据透视表对象的集合。

准备使用 Aspose.Cells for Node.js via C++

从 NPM 安装 Aspose.Cells for Node.js via C++，使用命令：$ npm install aspose.cells.node。
你也可以按照逐步指引将“Aspose.Cells for Node.js via C++”安装到你的开发环境中。

如何使用 Aspose.Cells for Node.js via C++ 添加数据透视表

使用 Aspose.Cells for Node.js via C++ 创建数据透视表的方法：

使用Cell对象的put_value方法向工作表单元格添加一些数据。也可以使用填充了数据的模板文件。这些数据将被用作数据透视表的数据源。
通过调用PivotTables集合的add方法（封装在Worksheet对象中）向工作表添加一个数据透视表。
通过传入索引从PivotTables集合中访问新的 PivotTable 对象。# 使用 PivotTable 对象中封装的任何数据透视表对象来管理表。

下面是代码示例。

如何使用 Aspose.Cells for Node.js via C++ 库添加数据透视图

使用 Aspose.Cells for Node.js via C++ 创建数据透视图的方法：

添加图表。
将图表的数据源设置为引用电子表格中的现有数据透视表。
设置其他属性。

Nodejscpp: 透视表和源数据

Mon, 01 Jan 0001 00:00:00 +0000

透视表的源数据

有时您希望创建从不同数据源（如数据库）获取数据的透视表的Microsoft Excel报表，在设计时这些数据源是未知的。本文介绍了一种动态更改透视表数据源的方法。

更改透视表的数据源

创建一个新的设计模板。
1. 创建一个新的设计模板文件，如下面的屏幕截图所示。
2. 然后定义一个名为DataSource的命名范围，该范围引用这些单元格。
  
  创建设计模板并定义命名范围，数据源

基于该命名范围创建数据透视表。
1. 在Microsoft Excel中，选择数据，然后选择数据透视表和数据透视图报表。
2. 根据第一步中创建的命名范围创建数据透视表。
  
  基于命名范围创建数据透视表，数据源

将相应字段拖放到数据透视表的行和列中，然后按照下面的截图创建结果的数据透视表。

基于相应字段创建数据透视表

右键单击数据透视表，然后选择表选项。
1. 在数据选项设置中选择打开时刷新。
  
  设置数据透视表选项

现在，您可以将此文件保存为您的设计模板文件。

填充新数据并更改数据透视表的源数据。
1. 一旦设计模板创建完成，使用以下代码修改数据透视表的源数据。

执行下面的示例代码会更改数据透视表的源数据。

Nodejscpp: 在数据透视表中添加计算字段

Mon, 01 Jan 0001 00:00:00 +0000

可能的使用场景

当您基于已知数据创建数据透视表时，您会发现其中的数据不是您想要的。您想要的数据是这些原始数据的组合。例如，您需要在希望获取数据之前对原始数据进行加法、减法、乘法和除法。这时，您需要构建一个计算字段并设置相应的计算公式。然后对计算字段执行一些统计和其他操作。

如何在Excel中的数据透视表中添加计算字段

在Excel中的数据透视表中插入计算字段，请按照以下步骤进行：

选择要向其添加计算字段的数据透视表。
转到功能区中的数据透视表分析选项卡。
单击“字段、项和集” ，然后从下拉菜单中选择“计算字段”。
在“名称”字段中输入计算字段的名称。
在"公式"字段中，输入要使用适当的数据透视表字段名称和数学运算符进行计算的公式。
单击"确定"创建计算字段。
新的计算字段将出现在数据透视表字段列表中的值部分。
将计算字段拖动到数据透视表的值部分中，以显示计算值。

如何使用Aspose.Cells for Node.js via C++库在数据透视表中添加计算字段。

使用Aspose.Cells for Node.js via C++向Excel文件中添加计算字段。请参见以下示例代码。执行示例代码后，工作表中会添加带有计算字段的数据透视表。

设置原始数据并创建数据透视表。
根据数据透视表中现有的PivotField创建计算字段。
将计算字段添加到数据区。
最后，以[out.xlsx]格式保存工作簿。

示例代码

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中刷新数据透视表

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells 提供了一个分层的刷新 API，允许您在四个不同的范围内重新加载透视数据——从整个工作簿到单个数据透视表。从 Aspose.Cells for Node.js via C++ v26.7 开始，旧版方法 PivotTable.RefreshData() 已标记为过时，应替换为本文介绍的更高效、支持缓存的 API。

概述

刷新数据透视表很少是一项单一的操作。在后台，Aspose.Cells 维护着一个分层的数据链，它将您的原始源数据连接到您在工作表中看到的呈现值。理解这条数据链是为任何场景选择正确的刷新 API 的关键。四层数据链如下：

数据源 (Data Source) — 原始的工作表区域、数据库查询或合并区域，原始值就保存在这里。
PivotCache — 源数据的内存快照。每个数据透视表都构建在 PivotCache 之上；所有数据都在这里进行收集和聚合。
PivotTable — 定义行、列、值和筛选字段的视图对象。PivotTable 仅从其 PivotCache 读取数据，不直接从数据源读取。
Cells — 工作表中 PivotTable 将其计算后的值和样式渲染到的工作表 Cells。一个特别重要的概念是共享缓存 (shared cache)。当工作簿中的多个数据透视表引用同一个源区域时，它们共享一个 PivotCache 实例。单个 PivotCache 可以被多个数据透视表引用，刷新该缓存会同时刷新所有依赖于它的 PivotTable。
PivotCache.SourceType（枚举 PivotTableSourceType）指示缓存数据的来源。截至 v26.7，PivotCache.Refresh() 仅支持 Sheet 和 Consolidation 源类型，即保存在工作表区域中的数据。外部源（数据库、外部连接等）尚无法通过缓存 API 进行刷新。
由于这种链式结构，Aspose.Cells 中存在两条基本的刷新路径：

PivotCache.Refresh() — 在单次操作中重新加载源 → 缓存，并重新计算所有依赖的 PivotTable。
PivotTable.CalculateData() — 从已缓存的数据重新计算某个 PivotTable 的显示，无需回溯到数据源。本文中所有场景均使用工作表单元格源数据，因此源类型为 Sheet，刷新操作的行为如上文所述。

所需的导入

本文中所有 JavaScript 示例均假定 Aspose.Cells for Node.js via C++ 模块已加载，并且透视类型位于 Aspose.Cells.Pivot 命名空间中。典型的设置如下：

const AsposeCells = require("aspose.cells.node");
const { PivotFieldType } = AsposeCells;（或者通过 AsposeCells.Pivot.PivotFieldType 访问）

刷新工作簿中的所有数据透视表

当您需要确保工作簿中的每个透视缓存和每个数据透视表都反映最新的源数据时，最简单且最全面的 API 是 Workbook.RefreshAll()。单次调用即可遍历整个工作簿——从其源刷新每个 PivotCache，然后重新计算每个依赖的 PivotTable。对于一般性的完整文档刷新（对性能没有特别要求时），这是推荐的方法。以下示例构建一个包含 Fruit/Year/Amount 源区域的工作簿，创建一个数据透视表，修改某些源值，然后使用 RefreshAll() 在一次调用中将所有内容更新到最新状态。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// 将表头行写入 A1:C1 单元格
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 将数据行写入 A2:C9 单元格(8 行水果数据,跨越 2020 和 2021 两年)
worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(50);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(60);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(70);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(80);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(90);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(100);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(110);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(120);

// 添加数据透视表:源数据区域为 "A1:C9",目标单元格为 "E3",名称为 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 设置数据透视表字段:Fruit 放入行字段,Year 放入列字段,Amount 放入数据字段
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 修改源数据中几个 Amount 的值以模拟数据变化
worksheet.getCells().get("C2").putValue(55);
worksheet.getCells().get("C5").putValue(85);
worksheet.getCells().get("C9").putValue(125);

// 刷新工作簿中的所有数据透视表/透视缓存
workbook.refreshAll();

// 保存工作簿
workbook.save("output.xlsx");

刷新单个工作表上的所有数据透视表

有时您只需要刷新位于某个特定工作表上的数据透视表——例如，当其他工作表上的透视表已知与本次刷新无关且不应被触动时。针对这种情况，Aspose.Cells 提供了 Worksheet.RefreshPivotTables()，其作用范围限定在单个 Worksheet 实例内。这比 Workbook.RefreshAll() 更加有选择性：仅刷新目标工作表上的数据透视表，其他工作表上的任何数据透视表均保持不变。以下示例填充相同的 Fruit/Year/Amount 源数据，在第一个工作表上添加一个数据透视表，修改某些源值，然后仅刷新该工作表上的数据透视表。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("blueberry");
worksheet.getCells().get("B3").putValue(2021);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("cherry");
worksheet.getCells().get("B5").putValue(2021);
worksheet.getCells().get("C5").putValue(120);

worksheet.getCells().get("A6").putValue("grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(180);

worksheet.getCells().get("A7").putValue("blueberry");
worksheet.getCells().get("B7").putValue(2020);
worksheet.getCells().get("C7").putValue(130);

worksheet.getCells().get("A8").putValue("kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(220);

worksheet.getCells().get("A9").putValue("cherry");
worksheet.getCells().get("B9").putValue(2020);
worksheet.getCells().get("C9").putValue(140);

let pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

worksheet.getCells().get("C2").putValue(300);
worksheet.getCells().get("C5").putValue(250);
worksheet.getCells().get("C9").putValue(400);

worksheet.refreshPivotTables();

workbook.save("output.xlsx");

刷新单个数据透视表

当您需要对单个数据透视表进行细粒度控制时，基于缓存的 API 为您提供了两种选择。两者之间的选择取决于实际发生变化的内容：底层的源数据，还是仅仅是数据透视表本身的视图/布局设置。

源数据已更改 — 使用 `PivotCache.Refresh()`

如果底层的源数据已发生更改，正确的入口是 pivotTable.PivotCache.Refresh()。此调用会重新读取源数据到缓存中，然后重新计算依赖于该缓存的每个 PivotTable。

由于数据透视表共享同一个 PivotCache 实例，调用 PivotCache.Refresh() 会重新计算基于同一缓存构建的所有数据透视表，而不仅仅是您所引用的那一个。如果两个数据透视表共享同一个源区域，刷新其中一个缓存会同时刷新两者。

以下示例在同一源区域上创建两个数据透视表以演示这种共享缓存行为，修改某些源值，然后通过一个缓存引用进行刷新。

const AsposeCells = require("aspose.cells");

// 创建新的工作簿并访问第一个工作表
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);

// 写入表头行：水果 / 年份 / 数量
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 写入大约 9 行数据（葡萄 / 蓝莓 / 猕猴桃 / 樱桃，分布在 2020-2021 年）
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

// 添加第一个数据透视表 "Pivot1"，锚定在 E3 单元格，源数据区域为 A1:C9
const pivotIndex1 = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
const pivotTable1 = worksheet.getPivotTables().get(pivotIndex1);

// 为 Pivot1 分配字段
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 添加第二个数据透视表 "Pivot2"，锚定在 E15，使用相同的源数据区域 A1:C9
// 由于源数据区域相同，Pivot1 和 Pivot2 共享同一个 PivotCache（透视缓存）。
const pivotIndex2 = worksheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
const pivotTable2 = worksheet.getPivotTables().get(pivotIndex2);

// 为 Pivot2 分配相同的字段
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 修改源数据中几个 Amount 单元格的值，以模拟数据变化
worksheet.getCells().get("C2").putValue(150);
worksheet.getCells().get("C4").putValue(350);
worksheet.getCells().get("C7").putValue(650);

// 刷新共享的 PivotCache。
// 由于 Pivot1 和 Pivot2 共享同一个 PivotCache，因此这一调用
// 会同时刷新这两个数据透视表（数据和样式）以反映更新后的源数据。
pivotTable1.getPivotCache().refresh();

// 保存工作簿
workbook.save("output.xlsx");

仅视图/布局已更改 — 使用 `CalculateData()`

如果源数据没有发生更改，只是数据透视表的视图或布局设置被修改（例如，一个字段被移动到了不同的区域，或者切换了“打开时刷新”设置），则无需回溯到数据源。缓存中已经保存了正确的数据；只需要重新计算呈现的 PivotTable。在这种情况下，pivotTable.CalculateData() 是正确的选择。这样可以避免不必要的源数据获取，并且在多个数据透视表共享同一缓存时，效率提升尤为显著。以下示例修改数据透视表的某个非源属性，然后调用 CalculateData() 从现有缓存重新渲染该透视表。

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);

// 写入 Fruit / Year / Amount 表头行
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 写入 8 行数据（第 2-9 行，匹配源数据范围 A1:C9）
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(150);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(250);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(350);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(450);

// 添加一个名为 "Pivot1" 的数据透视表，放置在目标单元格 E3，源数据范围为 A1:C9
var pivotIndex = worksheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 分配字段：Fruit 到行字段，Year 到列字段，Amount 到数据字段
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

// 修改视图/布局属性 —— 这只是展示性的更改，
// 因此不需要通过 PivotCache.Refresh() 重新读取源数据。
pivotTable.setRefreshDataOnOpeningFile(false);

// CalculateData() 会根据透视缓存中已有的数据重新渲染此透视表的显示（数据 + 样式）。
// 由于源数据未发生变化，因此不会执行与源的往返操作——只会将缓存的值重新计算到工作表单元格中。
pivotTable.calculateData();

// 将工作簿保存到磁盘
workbook.save("output.xlsx");

获取共享同一 PivotCache 的所有数据透视表

工作簿中常常包含许多数据透视表，它们都构建在一个共享缓存之上。若要枚举它们——例如，在执行批量刷新之前，或诊断共享缓存的影响——可以使用 PivotCache.GetPivotTables()。此方法返回依赖于该缓存的所有 PivotTable 的集合。这也是确认两个数据透视表确实共享同一个 PivotCache 实例的最直接方式：您可以比较缓存引用，或简单地遍历 GetPivotTables() 返回的集合，观察其中包含哪些数据透视表。以下示例在同一源区域上创建两个数据透视表，验证它们共享同一个缓存实例，然后枚举该缓存的数据透视表。

从过时的 `PivotTable.RefreshData()` 迁移

在 Aspose.Cells for Node.js via C++ v26.7 之前，刷新数据透视表的标准方式是对每个数据透视表分别调用 PivotTable.RefreshData()。从 v26.7 起，该方法被标记为过时，应替换为上文介绍的缓存感知型 API。在真实业务工作簿中，对每个表分别调用 RefreshData() 的方式存在两个问题：

它在每次调用时都会重新从源获取数据，即使源数据并未发生更改。
每次调用都会刷新整个共享缓存。当多个数据透视表共享同一个缓存时，逐个对每个数据透视表反复调用 RefreshData() 会导致同一个缓存被反复重新获取，速度非常慢。推荐替换方式如下：
刷新工作簿中的所有数据透视表 → 使用 workbook.refreshAll();
刷新其中一部分 → 对其中一个缓存使用 pivotTable.PivotCache.Refresh();。由于缓存是共享的，这单次调用会更新基于该缓存构建的所有数据透视表。已经基于已刷新缓存的其他数据透视表可以安全地跳过。
仅透视视图/布局发生变化 → 使用 pivotTable.CalculateData();，从现有缓存重新渲染，无需任何源回溯。以下示例演示了针对多个数据透视表共享单个缓存的工作簿的新型高效模式。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// --- 构建源数据：水果 / 年份 / 金额（表头 + 9 行数据） ---
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

sheet.getCells().get("A2").putValue("Grape");      sheet.getCells().get("B2").putValue(2020); sheet.getCells().get("C2").putValue(1000);
sheet.getCells().get("A3").putValue("Blueberry");  sheet.getCells().get("B3").putValue(2020); sheet.getCells().get("C3").putValue(2000);
sheet.getCells().get("A4").putValue("Kiwi");       sheet.getCells().get("B4").putValue(2020); sheet.getCells().get("C4").putValue(1500);
sheet.getCells().get("A5").putValue("Cherry");     sheet.getCells().get("B5").putValue(2020); sheet.getCells().get("C5").putValue(2500);
sheet.getCells().get("A6").putValue("Grape");      sheet.getCells().get("B6").putValue(2021); sheet.getCells().get("C6").putValue(3000);
sheet.getCells().get("A7").putValue("Blueberry");  sheet.getCells().get("B7").putValue(2021); sheet.getCells().get("C7").putValue(1800);
sheet.getCells().get("A8").putValue("Kiwi");       sheet.getCells().get("B8").putValue(2021); sheet.getCells().get("C8").putValue(2200);
sheet.getCells().get("A9").putValue("Cherry");     sheet.getCells().get("B9").putValue(2021); sheet.getCells().get("C9").putValue(2700);

// --- 在目标单元格 E3 处添加第一个数据透视表（Pivot1） ---
let idx1 = sheet.getPivotTables().add("A1:C9", "E3", "Pivot1");
let pivotTable1 = sheet.getPivotTables().get(idx1);
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable1.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- 在同一个源数据范围内添加第二个数据透视表（Pivot2） ---
// Pivot1 和 Pivot2 共用一个底层的 PivotCache（透视缓存）。
// 这正是一个典型的场景：在这种场景下，旧版的逐表调用 RefreshData()
// 方法效率很低：刷新一个表会重新拉取整个共享缓存，
// 因此刷新 N 个表就需要重复 N 次这种昂贵的拉取操作。
let idx2 = sheet.getPivotTables().add("A1:C9", "E15", "Pivot2");
let pivotTable2 = sheet.getPivotTables().get(idx2);
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable2.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// --- 修改源数据中的几个金额值 ---
sheet.getCells().get("C2").putValue(5000);   // 葡萄 2020
sheet.getCells().get("C5").putValue(7500);   // 樱桃 2020
sheet.getCells().get("C9").putValue(9500);   // 樱桃 2021

// --- 已废弃的模式（26.7 版本之前）— PivotTable.RefreshData() ---
// pivotTable1.RefreshData();  // 从源数据重新拉取，刷新整个缓存
// pivotTable2.RefreshData();  // 再次重新拉取 —— 但缓存此时已经是新的了！
// 每次调用都会重建共享缓存，因此 N 个表 = N 次冗余拉取。

// --- v26.7+ 新模式：只需刷新一次缓存，然后按需重新渲染 ---
// 只需调用一次 PivotCache.Refresh() 即可将修改后的值拉取到共享缓存中，
// 同时重新计算所有引用该缓存的数据透视表的显示。
// 因为 Pivot1 和 Pivot2 共享同一个 PivotCache，所以这一次调用就能更新
// 两个表 —— 无需再次访问源数据。
pivotTable1.getPivotCache().refresh();

// CalculateData() 仅重新渲染数据透视表的显示（数据和样式），
// 它使用的是缓存中已有的数据 —— 并不会访问源数据。
// 此处对 Pivot2 调用该方法纯粹是为了演示该 API：在缓存被刷新一次之后，
// 任何依赖该缓存的表都可以被重新渲染，而无需
// 再次访问源数据。当仅有透视表的视图/布局设置发生变化、且缓存为最新时，
// 可以单独使用 CalculateData() 方法。
pivotTable2.calculateData();

workbook.save("output.xlsx");

应该使用哪个刷新 API？

下表汇总了可用的刷新 API 及其适用场景。

目标	推荐 API	备注
刷新工作簿中的所有内容	`Workbook.RefreshAll()`	一次调用，覆盖所有缓存和表格。
仅刷新单个工作表上的数据透视表	`Worksheet.RefreshPivotTables()`	作用范围限定为一个工作表。
一个缓存的源数据已更改	`pivotTable.PivotCache.Refresh()`	刷新该共享缓存上的所有数据透视表。
仅视图/布局设置发生更改	`pivotTable.CalculateData()`	跳过不必要的源回溯。
列出共享缓存上的所有数据透视表	`pivotCache.GetPivotTables()`	用于在批量刷新之前枚举。
在实际使用中，应优先选择基于缓存的 API，而非过时的逐表 `RefreshData()`。它们能够感知共享缓存，可避免冗余的源获取，并允许您选择满足刷新需求的最小作用范围。

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中应用数据透视表样式

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells 支持应用旧式数据透视表自动格式（适用于 .xls 文件）以及现代命名或自定义数据透视表样式（适用于 .xlsx、.xlsm 和 .xlsb 文件）。您应调用的 API 取决于工作簿保存为的文件格式，而不是加载时的文件格式。

简介

Aspose.Cells 为数据透视表提供两种并行的样式 API。它们之间的选择取决于工作簿保存为的文件格式，而不是读取来源的格式。从 .xls 文件加载的工作簿可以重新保存为 .xlsx，此时应使用现代样式 API，而不是旧式 API。

对于旧式 .xls 输出，请使用 PivotTable.AutoFormatType 属性以及 Aspose.Cells.Pivot.PivotTableAutoFormatType 枚举。该 API 对应于经典 Excel 为数据透视表提供的自动格式选择器。

对于现代 .xlsx、.xlsm 和 .xlsb 输出，提供两种风格的样式 API：

PivotTable.PivotTableStyleType 用于选择内置命名样式之一（浅色和深色主题，包括 Excel 2017 中新增的样式）。这些预设是只读的。
PivotTable.PivotTableStyleName 用于选择您通过 Workbook.Worksheets.TableStyles.AddPivotTableStyle(...)) 自定义定义的样式。当您想要修改预设之外的颜色、边框或字体时，必须使用自定义样式。

此外，PivotTable.FormatAll(Style) 是一个快捷方法，可将单个 Style 对象应用于数据透视表的每个单元格，覆盖通过上述任一样式名称 API 设置的内容。当需要统一外观而不受底层主题影响时，此方法非常有用。

应用旧式 XLS 预设自动格式

PivotTable.AutoFormatType 接受 Aspose.Cells.Pivot.PivotTableAutoFormatType 枚举中的值。可用值包括 Report1 到 Report10、Classic 以及 Table1 到 Table10。

AutoFormatType 仅在工作簿保存为 .xls 时生效。当同一工作簿保存为 .xlsx、.xlsm 或 .xlsb 时，Excel 会忽略此属性，并回退到 PivotTableStyleType 和 PivotTableStyleName 设置。

下面的示例加载一个新工作簿，填充 Fruit/Year/Amount 示例数据，添加一个数据透视表，应用 PivotTableAutoFormatType.Report5，然后将结果保存为 .xls。

为什么没有列字段？ Report 系列自动格式（Report1 到 Report10、Table1 到 Table10）是在经典 Excel 中为单维度数据透视表设计的——只有行字段和值，没有为列字段标题提供内置样式。如果透视表需要列字段，请改用下方场景 2 中的现代 PivotTableStyleType 预设样式，它们专为现代 Excel 的二维布局而设计。

const AsposeCells = require("aspose.cells");

// 场景 1：应用旧版 XLS 预设自动格式
// 使用的 API：PivotTable.AutoFormatType
// 目标文件格式：.xls（旧版）
// 如需完整示例和数据文件，请访问 https://github.com/aspose-cells/Aspose.Cells-for-.NET

// 创建一个新的工作簿
const workbook = new AsposeCells.Workbook();

// 获取第一个工作表
const sheet = workbook.getWorksheets().get(0);

// 使用表头行（Fruit、Year、Amount）填充源数据
// 以及覆盖 2020 和 2021 年中 grape、blueberry、kiwi、cherry 的 9 行数据
sheet.getCells().get(0, 0).putValue("Fruit");
sheet.getCells().get(0, 1).putValue("Year");
sheet.getCells().get(0, 2).putValue("Amount");

sheet.getCells().get(1, 0).putValue("grape");
sheet.getCells().get(1, 1).putValue(2020);
sheet.getCells().get(1, 2).putValue(50);

sheet.getCells().get(2, 0).putValue("blueberry");
sheet.getCells().get(2, 1).putValue(2020);
sheet.getCells().get(2, 2).putValue(30);

sheet.getCells().get(3, 0).putValue("kiwi");
sheet.getCells().get(3, 1).putValue(2020);
sheet.getCells().get(3, 2).putValue(25);

sheet.getCells().get(4, 0).putValue("cherry");
sheet.getCells().get(4, 1).putValue(2020);
sheet.getCells().get(4, 2).putValue(40);

sheet.getCells().get(5, 0).putValue("grape");
sheet.getCells().get(5, 1).putValue(2021);
sheet.getCells().get(5, 2).putValue(60);

sheet.getCells().get(6, 0).putValue("blueberry");
sheet.getCells().get(6, 1).putValue(2021);
sheet.getCells().get(6, 2).putValue(35);

sheet.getCells().get(7, 0).putValue("kiwi");
sheet.getCells().get(7, 1).putValue(2021);
sheet.getCells().get(7, 2).putValue(28);

sheet.getCells().get(8, 0).putValue("cherry");
sheet.getCells().get(8, 1).putValue(2021);
sheet.getCells().get(8, 2).putValue(45);

sheet.getCells().get(9, 0).putValue("grape");
sheet.getCells().get(9, 1).putValue(2020);
sheet.getCells().get(9, 2).putValue(45);

// 在目标单元格 E3 处添加一个名为 "Pivot1" 的数据透视表，使用源区域 A1:C10
const pivotIndex = sheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
const pivotTable = sheet.getPivotTables().get(pivotIndex);

// 分配字段：Fruit -> 行，Year -> 列，Amount -> 数据
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 应用旧版 XLS 预设自动格式 "Report5"
// 注意：此属性仅在保存为 .xls 时有效。
// 当保存为 .xlsx/.xlsm/.xlsb 时，Excel 会忽略 AutoFormatType
// 并使用 PivotTableStyleType / PivotTableStyleName 所指定的样式。
pivotTable.setAutoFormatType(AsposeCells.PivotTableAutoFormatType.Report5);

// 以旧版 .xls 格式保存工作簿
workbook.save("output.xls");

应用现代命名预设数据透视表样式

PivotTable.PivotTableStyleType 接受 Aspose.Cells.PivotTableStyleType 枚举中的值。该枚举涵盖浅色主题 PivotTableStyleLight1 到 PivotTableStyleLight28 以及深色主题 PivotTableStyleDark1 到 PivotTableStyleDark28。Excel 2017 中新增的样式（浅色和深色主题的第二波）可通过同一枚举访问。

对于任何现代文件格式，这是推荐的 API。与旧式自动格式不同，此处选择的样式可被 Excel 准确呈现，并在其他 Office 工具的往返转换中保留。

下面的示例使用相同的 Fruit/Year/Amount 数据，创建相同的数据透视表，应用 PivotTableStyleDark1，并将工作簿保存为 .xlsx。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// 表头行：水果 / 年份 / 数量
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 9 行水果 / 年份 / 数量 数据
worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(150);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(200);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(180);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(120);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(170);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(210);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(190);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(130);

// 在 E3 添加一个名为 "Pivot1" 的数据透视表，数据源为 A1:C10
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 分配透视字段：水果 -> 行区域，年份 -> 列区域，数量 -> 数据区域
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 应用现代 Excel 2007+ 的命名预设透视表样式。
// PivotTableStyleType 是 .xlsx / .xlsm / .xlsb 文件的正确 API；AutoFormatType
// 在这些格式下会被 Excel 忽略。PivotTableStyleDark1 属于深色主题系列
// （PivotTableStyleDark1..PivotTableStyleDark28），同一枚举还公开了
// 较新的 Excel 2017 浅色/深色主题（PivotTableStyleLight1..Light28 / Dark1..Dark28）。
pivotTable.setPivotTableStyleType(AsposeCells.PivotTableStyleType.PivotTableStyleDark1);

// 保存为现代 .xlsx —— 这是 PivotTableStyleType 真正适用的格式。
workbook.save("output.xlsx");

定义并应用自定义数据透视表样式

内置预设无法修改。每当您需要覆盖颜色、边框或字体时，都必须定义自定义数据透视样式。工作流包括三个步骤：

通过 Workbook.Worksheets.TableStyles.AddPivotTableStyle(string name) 将自定义样式添加到工作簿的 TableStyles 集合中。这将返回新创建样式的索引。
通过 TableStyle.TableStyleElements.Add(TableStyleElementType) 添加元素（例如 WholeTable 或 GrandTotalRow），然后通过 TableStyleElement.SetElementStyle(Style) 为每个元素分配一个 Style，从而配置样式。
通过将 PivotTable.PivotTableStyleName 设置为样式的名称，将自定义样式应用于数据透视表。此处不要使用 PivotTableStyleType，因为该属性用于选择内置预设。

PivotTableStyleName 和 PivotTableStyleType 不可互换。请将 PivotTableStyleType 用于内置预设，将 PivotTableStyleName 用于您通过 AddPivotTableStyle 定义的自定义样式。同时设置两者无害，但仅会呈现与预期来源匹配的那一个。

可用的 TableStyleElementType 值包括 WholeTable、FirstRow、LastRow、FirstColumn、LastColumn、GrandTotalRow、GrandTotalColumn、PageFieldLabels 和 PageFieldValues。

下面的示例定义一个自定义数据透视样式，在 WholeTable 上具有细黑色边框，在 GrandTotalRow 上具有加粗的红色字体，然后通过 PivotTableStyleName 应用它并保存为 .xlsx。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// 填充源数据：表头行 + 9 行数据 (A1:C10)
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(100);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(200);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(300);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(400);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(500);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(600);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(700);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(800);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(900);

// 添加数据透视表，源数据为 A1:C10，定位在 E3，名称为 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 步骤 1：注册一个新的自定义数据透视表样式并获取其索引
let styleIndex = workbook.getWorksheets().getTableStyles().addPivotTableStyle("CustomPivotStyle");
let tableStyle = workbook.getWorksheets().getTableStyles().get(styleIndex);

// 步骤 2：添加一个 WholeTable 元素，并在四边应用细的黑色边框
let wholeTableElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.WholeTable);
let wholeTableElement = tableStyle.getTableStyleElements().get(wholeTableElementIndex);
let wholeTableStyle = workbook.createStyle();
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
wholeTableStyle.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);
wholeTableElement.setElementStyle(wholeTableStyle);

// 步骤 3：添加一个 GrandTotalRow 元素，并应用粗体红色字体
let grandTotalElementIndex = tableStyle.getTableStyleElements().add(AsposeCells.TableStyleElementType.GrandTotalRow);
let grandTotalElement = tableStyle.getTableStyleElements().get(grandTotalElementIndex);
let grandTotalStyle = workbook.createStyle();
grandTotalStyle.getFont().setIsBold(true);
grandTotalStyle.getFont().setColor(AsposeCells.Color.Red);
grandTotalElement.setElementStyle(grandTotalStyle);

// 步骤 4：通过名称应用自定义样式（不要使用 PivotTableStyleType，它是用于内置预设样式的）
pivotTable.setPivotTableStyleName("CustomPivotStyle");

workbook.save("output.xlsx");

使用 FormatAll 将一个样式应用于数据透视表的每个单元格

PivotTable.FormatAll(Style) 是一个快捷方法，可将单个 Style 对象应用于数据透视表的每个单元格，包括数据区域、行和列标题以及总计。之前通过 PivotTableStyleType 或 PivotTableStyleName 设置的内容将被覆盖。

FormatAll 会覆盖 PivotTableStyleType 和 PivotTableStyleName。仅当在整个数据透视表中需要统一且不依赖主题的外观时才使用它。

下面的示例创建一个具有黄色实心填充、加粗的深蓝色字体以及四周细黑色边框的 Style，然后使用 FormatAll 应用它并保存为 .xlsx。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);

// 填充源数据：表头行（第1行）+ 9个数据行（第2-10行）
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

worksheet.getCells().get("A2").putValue("Grape");
worksheet.getCells().get("B2").putValue(2020);
worksheet.getCells().get("C2").putValue(5000);

worksheet.getCells().get("A3").putValue("Blueberry");
worksheet.getCells().get("B3").putValue(2020);
worksheet.getCells().get("C3").putValue(3000);

worksheet.getCells().get("A4").putValue("Kiwi");
worksheet.getCells().get("B4").putValue(2020);
worksheet.getCells().get("C4").putValue(4000);

worksheet.getCells().get("A5").putValue("Cherry");
worksheet.getCells().get("B5").putValue(2020);
worksheet.getCells().get("C5").putValue(2000);

worksheet.getCells().get("A6").putValue("Grape");
worksheet.getCells().get("B6").putValue(2021);
worksheet.getCells().get("C6").putValue(6000);

worksheet.getCells().get("A7").putValue("Blueberry");
worksheet.getCells().get("B7").putValue(2021);
worksheet.getCells().get("C7").putValue(3500);

worksheet.getCells().get("A8").putValue("Kiwi");
worksheet.getCells().get("B8").putValue(2021);
worksheet.getCells().get("C8").putValue(4500);

worksheet.getCells().get("A9").putValue("Cherry");
worksheet.getCells().get("B9").putValue(2021);
worksheet.getCells().get("C9").putValue(2500);

worksheet.getCells().get("A10").putValue("Grape");
worksheet.getCells().get("B10").putValue(2021);
worksheet.getCells().get("C10").putValue(5500);

// 添加数据透视表：源数据范围 A1:C10，目标单元格 E3，名称 "Pivot1"
let pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "Pivot1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 分配透视字段：Fruit -> 行区域，Year -> 列区域，Amount -> 数据区域
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 创建一个样式，将强制应用于数据透视表的每个单元格
let style = workbook.createStyle();
style.setForegroundColor(AsposeCells.Color.Yellow);
style.setPattern(AsposeCells.BackgroundType.Solid);
style.getFont().setIsBold(true);
style.getFont().setColor(AsposeCells.Color.DarkBlue);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.TopBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.BottomBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.LeftBorder).setColor(AsposeCells.Color.Black);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setLineStyle(AsposeCells.CellBorderType.Thin);
style.getBorders().get(AsposeCells.BorderType.RightBorder).setColor(AsposeCells.Color.Black);

// 应用 FormatAll：将此单一样式强制应用于数据透视表的每个单元格，
// 覆盖之前设置的任何 PivotTableStyleType / PivotTableStyleName
pivotTable.formatAll(style);

// 以现代 .xlsx 格式保存工作簿
workbook.save("output.xlsx");

我应该使用哪种样式 API？

样式 API 的选择取决于您要保存为的文件格式。请使用下表作为快速参考。

目标文件格式	使用的 API	备注
`.xls`（旧式）	`PivotTable.AutoFormatType`	取值来自 `Aspose.Cells.Pivot.PivotTableAutoFormatType`（例如 `Report1`–`Report10`、`Classic`、`Table1`–`Table10`）。保存为现代格式时将被忽略。
`.xlsx` / `.xlsm` / `.xlsb`（现代，内置样式）	`PivotTable.PivotTableStyleType`	取值来自 `Aspose.Cells.PivotTableStyleType`（浅色/深色主题，包括 Excel 2017 新增的样式）。
`.xlsx` / `.xlsm` / `.xlsb`（现代，自定义样式）	`PivotTable.PivotTableStyleName` + `Worksheets.TableStyles.AddPivotTableStyle(...)`	内置预设不够用时使用。通过 `TableStyleElement.SetElementStyle(...)` 进行配置。
任何格式（统一覆盖）	`PivotTable.FormatAll(Style)`	快捷方法，覆盖整个数据透视表上的所有其他样式设置。

如有疑问，请保存为 .xlsx，并对内置主题使用 PivotTableStyleType，对自定义主题使用 PivotTableStyleName。

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中添加数据透视表的行字段和列字段

Mon, 01 Jan 0001 00:00:00 +0000

向行或列区域添加字段

PivotTable.AddFieldToArea(PivotFieldType fieldType, string fieldName) 方法将一个基础字段从源数据移动到四个透视区域之一。fieldType 参数接受以下 PivotFieldType 值之一。

Row — 垂直放置在左侧的字段
Column — 水平放置在顶部的字段
Data — 其值被聚合的字段
Page — 用作报表筛选器的字段

添加字段后，您可以通过 PivotTable.RowFields 和 PivotTable.ColumnFields 属性访问它们。每个属性返回一个 PivotFieldCollection。RowFields 索引 0 处的字段是最外层的行字段，后续索引表示嵌套在其内部的字段。相同的索引约定也适用于 ColumnFields。

字段的嵌套顺序很重要。先向行区域添加 Category，然后再添加 Item，会产生一个外部分组为 Category、内部分组为 Item 的透视表。反转该顺序则会反转层级结构。

透视字段小计

PivotField.SetSubtotals(PivotFieldSubtotalType subtotalType, bool shown) 方法控制透视字段显示哪些小计行。每次调用都会独立切换一种小计类型。传递 shown = true 将显示小计，而传递 shown = false 则会隐藏它。由于每次调用只影响一种类型，因此使用不同的 subtotalType 值多次调用该方法可以构建自定义的小计子集。

PivotFieldSubtotalType 枚举定义了可用的小计种类。

Automatic — Aspose.Cells 选择默认选项（通常对数值字段为 Sum）
None — 抑制所有小计行
Sum
Count
Average
Max
Min
Product
StdDev
StdDevp
Var
Varp

小计仅在行区域（或列区域）中存在两个或更多透视字段时才会呈现。单个字段之间没有可供小计的有意义内容，因此在这种情况下 SetSubtotals 调用没有可见效果。因此本文在每个示例中都放置两个行字段（外层 Category，内层 Item），以便每个 Category 组之间的小计边界可见。

场景 1 — 自动（默认）小计

当您根本不调用 SetSubtotals 时，Aspose.Cells 会将 Automatic 选择应用于数值字段。以下示例通过对外部 Category 行字段调用 SetSubtotals(PivotFieldSubtotalType.Automatic, true) 来显式确认此行为。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Automatic, true);

pivotTable.calculateData();

workbook.save("output_automatic.xlsx");

场景 2 — 抑制所有小计 (None)

调用 SetSubtotals(PivotFieldSubtotalType.None, true) 会从透视表中移除所有小计行，仅保留字段行和底部总计。当您希望查看不带任何汇总行的原始分组数据时，这非常有用。

const AsposeCells = require("aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

const headers = ["Category", "Item", "Year", "Amount"];
for (let j = 0; j < headers.length; j++) {
    worksheet.getCells().get(0, j).putValue(headers[j]);
}

const data = [
    ["Fruit",     "Apple",  2020, 100],
    ["Fruit",     "Apple",  2021, 150],
    ["Fruit",     "Banana", 2020, 80],
    ["Fruit",     "Banana", 2021, 90],
    ["Vegetable", "Carrot", 2020, 50],
    ["Vegetable", "Carrot", 2021, 60],
    ["Vegetable", "Daikon", 2020, 40],
    ["Vegetable", "Daikon", 2021, 45]
];

for (let i = 0; i < data.length; i++) {
    for (let j = 0; j < data[i].length; j++) {
        worksheet.getCells().get(i + 1, j).putValue(data[i][j]);
    }
}

const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1");
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

const categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.None, true);
pivotTable.calculateData();

workbook.save("output_none.xlsx");

场景 3 — 自定义小计子集 (Sum + Average)

您不仅限于单一的小计类型。每次 SetSubtotals 调用都独立作用于一种类型，因此使用 Sum 和 Average 各调用一次该方法，可以为每个 Category 组生成两个小计行的自定义子集。

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get("A1").putValue("Category");
worksheet.getCells().get("B1").putValue("Item");
worksheet.getCells().get("C1").putValue("Year");
worksheet.getCells().get("D1").putValue("Amount");

worksheet.getCells().get(1, 0).putValue("Fruit");
worksheet.getCells().get(1, 1).putValue("Apple");
worksheet.getCells().get(1, 2).putValue(2020);
worksheet.getCells().get(1, 3).putValue(100);

worksheet.getCells().get(2, 0).putValue("Fruit");
worksheet.getCells().get(2, 1).putValue("Apple");
worksheet.getCells().get(2, 2).putValue(2021);
worksheet.getCells().get(2, 3).putValue(150);

worksheet.getCells().get(3, 0).putValue("Fruit");
worksheet.getCells().get(3, 1).putValue("Banana");
worksheet.getCells().get(3, 2).putValue(2020);
worksheet.getCells().get(3, 3).putValue(80);

worksheet.getCells().get(4, 0).putValue("Fruit");
worksheet.getCells().get(4, 1).putValue("Banana");
worksheet.getCells().get(4, 2).putValue(2021);
worksheet.getCells().get(4, 3).putValue(90);

worksheet.getCells().get(5, 0).putValue("Vegetable");
worksheet.getCells().get(5, 1).putValue("Carrot");
worksheet.getCells().get(5, 2).putValue(2020);
worksheet.getCells().get(5, 3).putValue(50);

worksheet.getCells().get(6, 0).putValue("Vegetable");
worksheet.getCells().get(6, 1).putValue("Carrot");
worksheet.getCells().get(6, 2).putValue(2021);
worksheet.getCells().get(6, 3).putValue(60);

worksheet.getCells().get(7, 0).putValue("Vegetable");
worksheet.getCells().get(7, 1).putValue("Daikon");
worksheet.getCells().get(7, 2).putValue(2020);
worksheet.getCells().get(7, 3).putValue(40);

worksheet.getCells().get(8, 0).putValue("Vegetable");
worksheet.getCells().get(8, 1).putValue("Daikon");
worksheet.getCells().get(8, 2).putValue(2021);
worksheet.getCells().get(8, 3).putValue(45);

let pivotTables = worksheet.getPivotTables();
let pivotIndex = pivotTables.add("A1:D9", "F3", "PivotTable1");
let pivotTable = pivotTables.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let categoryField = pivotTable.getRowFields().get(0);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Sum, true);
categoryField.setSubtotals(AsposeCells.PivotFieldSubtotalType.Average, true);

pivotTable.calculateData();

workbook.save("output_custom.xlsx");

总结

上述三个场景共享相同的数据集和透视表结构。它们之间唯一的区别是应用于外部 Category 行字段的 SetSubtotals 调用。请记住两个字段的规则：区域中只有一个字段时没有内容可供小计，因此当您希望 SetSubtotals 产生可见效果时，请始终在行或列区域中放置至少两个字段。

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中管理数据透视表的值字段

Mon, 01 Jan 0001 00:00:00 +0000

Adding a Field to the Data Region

→ ## 向数据区域添加字段

“Adding a base field to the data (value) region is the first step in shaping how a pivot table aggregates your source data.” → “向数据(值)区域添加基础字段是塑造数据透视表如何聚合源数据的第一步。”

“Aspose.Cells exposes PivotTable.addFieldToArea(PivotFieldType, string), an overload that accepts the constant PivotFieldType.Data and the source-column name.” → “Aspose.Cells 公开了 PivotTable.addFieldToArea(PivotFieldType, string),这是一个接受常量 PivotFieldType.Data 和源列名称的重载。”

“Once a field is added to the data region, the API exposes it through the PivotTable.getDataFields() collection, in the order in which the fields were added.” → “一旦字段被添加到数据区域,API 会通过 PivotTable.getDataFields() 集合公开它,顺序与字段添加顺序一致。”

“By default, a numeric source column is summarised with ConsolidationFunction.Sum, while a non-numeric column defaults to Count.” → “默认情况下,数值型源列使用 ConsolidationFunction.Sum 进行汇总,而非数值型列默认使用 Count。”

aspose.cells");

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// A1:D1 中的表头
worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

// 使用嵌套循环根据 j 分支处理 A2:D9 数据行
for (let i = 1; i <= 8; i++) {
 for (let j = 0; j < 4; j++) {
 switch (j) {
 case 0:
 worksheet.getCells().get(i, j).putValue(i <= 4 ? "Fruit" : "Vegetable");
 break;
 case 1:
 if (i === 1 || i === 2) worksheet.getCells().get(i, j).putValue("Apple");
 else if (i === 3 || i === 4) worksheet.getCells().get(i, j).putValue("Banana");
 else if (i === 5 || i === 6) worksheet.getCells().get(i, j).putValue("Carrot");
 else worksheet.getCells().get(i, j).putValue("Daikon");
 break;
 case 2:
 worksheet.getCells().get(i, j).putValue(2020 + ((i - 1) % 2));
 break;
 case 3:
 if (i === 1) worksheet.getCells().get(i, j).putValue(100);
 else if (i === 2) worksheet.getCells().get(i, j).putValue(150);
 else if (i === 3) worksheet.getCells().get(i, j).putValue(80);
 else if (i === 4) worksheet.getCells().get(i, j).putValue(90);
 else if (i === 5) worksheet.getCells().get(i, j).putValue(50);
 else if (i === 6) worksheet.getCells().get(i, j).putValue(60);
 else if (i === 7) worksheet.getCells().get(i, j).putValue(40);
 else worksheet.getCells().get(i, j).putValue(45);
 break;
 }
 }
}

// 在 F3 位置添加名为 PivotTable1 的数据透视表
const pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
const pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 数据透视表布局：Category 和 Item 放在行，Year 放在列，Amount 作为数据字段
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.Pivot.PivotFieldType.Data, "Amount");

pivotTable.calculateData();
workbook.save("output_drag.xlsx");

Changing the Summary Function

→ ## 更改汇总函数

“Every field placed in the data region is wrapped internally as a PivotField instance, and its getFunction() property returns a value from the ConsolidationFunction enum.” → “放置在数据区域中的每个字段在内部被包装为 PivotField 实例,其 getFunction() 属性返回 ConsolidationFunction 枚举中的一个值。”

→ “同一个 setFunction() setter 可让您在可用的聚合之间切换,包括 Sum、Count、Average、Max、Min、Product、StdDev、StdDevp、Var 和 Varp。”

Alert: “Changing the summary function only affects the aggregate, the source column does not change.” → “更改汇总函数只会影响聚合结果,源列不会改变。”

→ “因此,您可以在单个数据透视表中将一个数据字段保留为 Sum,同时添加第二个针对同一源列但使用 Count 或 Average 的数据字段。”

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0)
 {
 worksheet.getCells().get(i, j).putValue(i <= 5 ? "Fruit" : "Vegetable");
 }
 else if (j == 1)
 {
 let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
 worksheet.getCells().get(i, j).putValue(items[i - 1]);
 }
 else if (j == 2)
 {
 let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
 worksheet.getCells().get(i, j).putValue(years[i - 1]);
 }
 else
 {
 let amounts = [100, 150, 80, 90, 50, 60, 40, 45];
 worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

let countField = pivotTable.getDataFields().get(1);
countField.setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.calculateData();

workbook.save("output_function.xlsx");

Plotting Value Fields to Row or Column Axis

→ ## 将值字段绘制到行轴或列轴

“When a pivot table contains two or more data fields, Aspose.Cells exposes an additional virtual field called PivotTable.getValuesField.” → “当数据透视表包含两个或更多数据字段时,Aspose.Cells 会公开一个名为 PivotTable.getValuesField 的额外虚拟字段。”

“This virtual field represents the aggregate of every data field that lives in the data region.” → “该虚拟字段表示位于数据区域中的每个数据字段的聚合。”

“You can drag it into the Row or Column region as a base pivot field, which is useful for laying out multiple measures side by side.” → “您可以将其作为基础数据透视字段拖动到行区域或列区域,这对于并排放置多个度量值非常有用。”

Alert: “PivotTable.getValuesField() does not work if there is no or only one value field.” → “如果没有值字段或只有一个值字段,PivotTable.getValuesField() 无法使用。”

"" → “下面的场景通过三个端到端示例演示针对同一数据透视表结构的上述每个功能。”

let workbook = new AsposeCells.Workbook();
let worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

worksheet.getCells().get(0, 0).putValue("Category");
worksheet.getCells().get(0, 1).putValue("Item");
worksheet.getCells().get(0, 2).putValue("Year");
worksheet.getCells().get(0, 3).putValue("Amount");

let categories = ["Fruit", "Fruit", "Fruit", "Fruit", "Vegetable", "Vegetable", "Vegetable", "Vegetable"];
let items = ["Apple", "Apple", "Banana", "Banana", "Carrot", "Carrot", "Daikon", "Daikon"];
let years = [2020, 2021, 2020, 2021, 2020, 2021, 2020, 2021];
let amounts = [100, 150, 80, 90, 50, 60, 40, 45];

for (let i = 1; i <= 8; i++)
{
 for (let j = 0; j <= 3; j++)
 {
 if (j == 0) worksheet.getCells().get(i, j).putValue(categories[i - 1]);
 else if (j == 1) worksheet.getCells().get(i, j).putValue(items[i - 1]);
 else if (j == 2) worksheet.getCells().get(i, j).putValue(years[i - 1]);
 else worksheet.getCells().get(i, j).putValue(amounts[i - 1]);
 }
}

let pivotIndex = worksheet.getPivotTables().add("A1:D9", "F3", "PivotTable1", true, false);
let pivotTable = worksheet.getPivotTables().get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Category");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Item");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, "Year");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

pivotTable.getDataFields().get(1).setFunction(AsposeCells.ConsolidationFunction.Count);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Column, pivotTable.getValuesField());

pivotTable.calculateData();
workbook.save("output_plot.xlsx");

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中向数据透视表添加筛选字段

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells 支持数据透视表中筛选字段的完整生命周期。您可以通过高级便捷 API 或底层的 PageFields 集合来添加筛选字段，并且可以以单选模式驱动筛选器、清除筛选器以显示所有筛选项，或者将该字段切换到多选模式，以便用户能够通过 Excel 中的复选框 UI 同时选择多个筛选项。

简介

筛选字段是一种数据透视字段，用于控制数据透视表主体所显示的源数据的哪个子集。终端用户在 Excel 中看到的是渲染后数据透视表顶部的一个下拉列表，从可用的筛选项中选择一个后，数据透视表主体会重新构建，使得仅属于该筛选项的记录被汇总。当某个数据透视字段被注册为 PivotFieldType.Page（而不是 PivotFieldType.Row、PivotFieldType.Column 或 PivotFieldType.Data）时，它就成为一个筛选字段。

筛选字段可以以两种行为方式运行。在默认的单选行为下，每次仅可见一个筛选项，因此数据透视表主体恰好汇总一个子集。在多选行为下，该字段会显示一个复选框列表，数据透视表主体会汇总所有勾选的筛选项的并集。同一源字段可以通过切换单个属性在这两种行为之间来回切换。

Aspose.Cells for Node.js via C++ 提供了两种等效的方式来注册筛选字段。高级 API 是 PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")，它接受源列名称并通过一次调用添加该字段。底层 API 是 PivotTable.pageFields.add(PivotField)，它用于当您已经持有 PivotField 引用并希望将同一字段实例添加到筛选区域时使用。这两个 API 最终都会填充同一个 PageFields 集合，本文的其余部分将演示如何在它们之间进行选择以及如何驱动每种筛选模式。

添加筛选字段

在筛选区域中注册数据透视字段有两种方式。高级调用接受源列名称作为字符串，是最常用的路径。底层调用接受一个已存在的 PivotField 实例，当同一字段对象必须跨多个数据透视区域重用时非常方便。两种调用都会将字段放入 PivotTable.pageFields 中，此后该字段便会作为渲染后数据透视表顶部的页面下拉列表出现。

使用 addFieldToArea 添加筛选字段

以下示例构建一个小的 Fruit / Year / Amount 数据集，在 E3 单元格处放置一个数据透视表，其中 Fruit 放在行区域，Amount 放在数据区域，Year 放在筛选区域，刷新数据透视表，然后保存工作簿。

var workbook = new AsposeCells.Workbook();
var worksheet = workbook.getWorksheets().get(0);
worksheet.setName("Data");

// 设置表头行
worksheet.getCells().get("A1").putValue("Fruit");
worksheet.getCells().get("B1").putValue("Year");
worksheet.getCells().get("C1").putValue("Amount");

// 填充9行示例数据：水果、年份、数量
var data = [
    [ "apple", 2020, 100 ],
    [ "banana", 2021, 200 ],
    [ "apple", 2021, 150 ],
    [ "grape", 2020, 120 ],
    [ "orange", 2022, 180 ],
    [ "banana", 2020, 90 ],
    [ "grape", 2021, 130 ],
    [ "apple", 2022, 170 ],
    [ "orange", 2021, 110 ]
];

for (var i = 0; i < data.length; i++)
{
    worksheet.getCells().get(i + 1, 0).putValue(data[i][0]);
    worksheet.getCells().get(i + 1, 1).putValue(data[i][1]);
    worksheet.getCells().get(i + 1, 2).putValue(data[i][2]);
}

// 添加以单元格E3为锚点的数据透视表
var pivotIndex = worksheet.getPivotTables().add("A1:C10", "E3", "PivotTable1");
var pivotTable = worksheet.getPivotTables().get(pivotIndex);

// 将字段添加到各区域：水果作为行字段，数量作为数据字段，年份作为页字段
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// 刷新并计算数据透视表数据
pivotTable.calculateData();

// 保存工作簿
workbook.save("pageFieldSample.xlsx");

使用 pageFields.add 添加筛选字段

当您已经在使用一个 PivotField 实例时，可以直接将其传递给 PivotTable.pageFields.add。数据透视表和筛选字段的构建方式与上一场景完全相同；只是最终的筛选区域注册被替换为底层 API 调用。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// 表头
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

// 示例数据（9行）
sheet.getCells().get("A2").putValue("apple");     sheet.getCells().get("B2").putValue("2020"); sheet.getCells().get("C2").putValue(100);
sheet.getCells().get("A3").putValue("apple");     sheet.getCells().get("B3").putValue("2021"); sheet.getCells().get("C3").putValue(150);
sheet.getCells().get("A4").putValue("apple");     sheet.getCells().get("B4").putValue("2022"); sheet.getCells().get("C4").putValue(200);
sheet.getCells().get("A5").putValue("grape");     sheet.getCells().get("B5").putValue("2020"); sheet.getCells().get("C5").putValue(300);
sheet.getCells().get("A6").putValue("grape");     sheet.getCells().get("B6").putValue("2021"); sheet.getCells().get("C6").putValue(400);
sheet.getCells().get("A7").putValue("grape");     sheet.getCells().get("B7").putValue("2022"); sheet.getCells().get("C7").putValue(500);
sheet.getCells().get("A8").putValue("blueberry"); sheet.getCells().get("B8").putValue("2020"); sheet.getCells().get("C8").putValue(250);
sheet.getCells().get("A9").putValue("blueberry"); sheet.getCells().get("B9").putValue("2021"); sheet.getCells().get("C9").putValue(350);
sheet.getCells().get("A10").putValue("blueberry");sheet.getCells().get("B10").putValue("2022"); sheet.getCells().get("C10").putValue(450);

// 在E3位置添加数据透视表，覆盖A1:C10
let pivotIndex = sheet.getPivotTables().add("E3", "A1:C10", "PivotTable1");
let pivotTable = sheet.getPivotTables().get(pivotIndex);

// 水果 -> 行，金额 -> 数据（年份将放到下面的页面）
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");

// 底层方法：从BaseFields中获取现有的年份透视字段，
// 并通过PageFields.Add(PivotField)将其注册到页面区域。
let yearField = pivotTable.getBaseFields().get("Year");
pivotTable.getPageFields().add(yearField);

// 刷新以便在保存的工作簿中反映新的页面字段
pivotTable.calculateData();

workbook.save("output.xlsx");

单选筛选（显示一个筛选项）

在默认的单选行为下，筛选字段呈现为单个下拉列表，PivotField.currentPageItem 整数用于选择哪个筛选项驱动数据透视表主体。赋一个具体的索引值会选中该单项；赋一个特殊的哨兵值 0x7FFD（十进制 32765）则会清除筛选器，从而一次性汇总所有筛选项。单选是默认行为，您无需显式启用。

显示所有项

将 currentPageItem 设置为特殊值 0x7FFD 等同于清除筛选器：数据透视表主体会汇总所有筛选项，就像没有应用筛选器一样。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);

// 填充 水果/年份/金额 数据
sheet.getCells().get("A1").putValue("Fruit");
sheet.getCells().get("B1").putValue("Year");
sheet.getCells().get("C1").putValue("Amount");

let data = [
    ["Apple", 2022, 100],
    ["Apple", 2023, 150],
    ["Banana", 2022, 80],
    ["Banana", 2023, 120],
    ["Cherry", 2022, 200],
    ["Cherry", 2023, 250]
];

for (let r = 0; r < data.length; r++) {
    for (let c = 0; c < data[r].length; c++) {
        sheet.getCells().get(r + 1, c).putValue(data[r][c]);
    }
}

// 在 E3 创建数据透视表
let pivotTables = sheet.getPivotTables();
let index = pivotTables.add("=A1:C7", "E3", "PivotTable1");
let pivotTable = pivotTables.get(index);

// 配置数据透视表字段：水果→行，金额→数据，年份→页
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

pivotTable.calculateData();

// 清除页面筛选器，以便页面字段中的每个项目都可见。
// 0x7FFD（十进制 32765）是表示"所有项目"的特殊哨兵值 —
// 相当于在 Excel 的页面字段下拉列表中选择"（全部）"。
pivotTable.getPageFields().get(0).setCurrentPageItem(0x7FFD);

workbook.save("output.xlsx");

显示一个特定项

将 currentPageItem 设置为实际索引值即可选中那一个筛选项。该索引是筛选字段已排序项列表中的位置，因此例如 1 会在排序后选中第二项。

var workbook = new AsposeCells.Workbook();
var sheet = workbook.getWorksheets().get(0);
var cells = sheet.getCells();

// 添加示例数据（水果/年份/金额）
cells.get("A1").putValue("Fruit");
cells.get("B1").putValue("Year");
cells.get("C1").putValue("Amount");

cells.get("A2").putValue("Apple");
cells.get("B2").putValue("2020");
cells.get("C2").putValue("100");

cells.get("A3").putValue("Apple");
cells.get("B3").putValue("2021");
cells.get("C3").putValue("150");

cells.get("A4").putValue("Banana");
cells.get("B4").putValue("2020");
cells.get("C4").putValue("200");

cells.get("A5").putValue("Banana");
cells.get("B5").putValue("2021");
cells.get("C5").putValue("250");

// 在 E3 处添加数据透视表
var pivotTables = sheet.getPivotTables();
var pivotIndex = pivotTables.add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables.get(pivotIndex);

// 添加字段：水果→行，金额→数据，年份→页
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// 页字段特定操作
pivotTable.getPageFields().get(0).setCurrentPageItem(1); // 1 = 排序顺序中的第二项（例如 "2021"）

// 刷新并计算数据透视表
pivotTable.calculateData();

workbook.save("output.xlsx");

多选筛选

多选筛选将页面下拉列表转换为复选框列表，并允许终端用户同时选择多个筛选项。Aspose.Cells 公开了两个协同工作的属性。必须先将 PivotField.isMultipleItemSelectionAllowed 设置为 true，多选 UI 才会生效。启用之后，PivotItem.isHidden 控制哪些项出现在复选框列表中，因此您可以显示所有项，也可以仅白名单显示特定项。

下面的代码在场景 1a 中构建的同一 Year 筛选字段上启用多选，然后展示两种模式：A 部分通过对每个项保留 isHidden 为 false 来显示所有筛选项，而 B 部分通过 switch (pivotItems[i].getStringValue()) 块仅白名单您选择的源值并隐藏其他所有项。

let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cells = sheet.getCells();

// 示例数据：水果 | 年份 | 数量
cells.get(0, 0).putValue("Fruit");
cells.get(0, 1).putValue("Year");
cells.get(0, 2).putValue("Amount");

let data = [
    ["apple", "2019", "100"],
    ["apple", "2020", "150"],
    ["apple", "2021", "200"],
    ["banana", "2019", "110"],
    ["banana", "2020", "160"],
    ["banana", "2021", "210"],
    ["grape", "2019", "120"],
    ["grape", "2020", "170"],
    ["grape", "2021", "220"]
];

for (let i = 0; i < data.length; i++) {
    cells.get(i + 1, 0).putValue(data[i][0]);
    cells.get(i + 1, 1).putValue(parseInt(data[i][1]));
    cells.get(i + 1, 2).putValue(parseInt(data[i][2]));
}

let pivotSheet = workbook.getWorksheets().add("Pivot");
let pivots = pivotSheet.getPivotTables();
let pivotIndex = pivots.add("E3", "A1:C10", "PivotTable1");
let pivotTable = pivots.get(pivotIndex);

pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Row, "Fruit");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Data, "Amount");
pivotTable.addFieldToArea(AsposeCells.PivotFieldType.Page, "Year");

// — 在页面字段上启用多选
pivotTable.getPageFields().get(0).setIsMultipleItemSelectionAllowed(true);

// 部分 A — 选择所有项（使每个项都可见）
let pivotItems = pivotTable.getPageFields().get(0).getPivotItems();
for (let i = 0; i < pivotItems.getCount(); i++) {
    pivotItems.get(i).setIsHidden(false);
}

// 部分 B — 按源值仅选择特定项
for (let i = 0; i < pivotItems.getCount(); i++) {
    switch (pivotItems.get(i).getStringValue()) {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems.get(i).setIsHidden(false);
            break;
        default:
            pivotItems.get(i).setIsHidden(true);
            break;
    }
}

pivotTable.calculateData();

workbook.save("output.xlsx");

注意： 当通过 PivotItem.isHidden 使用多选筛选时，必须至少有一个 PivotItem 保持可见（isHidden == false）。如果所有项都被隐藏，Excel 在打开文件时要么崩溃，要么渲染一个空白的数据透视表。请始终确认您的多选白名单至少包含源数据中的一个项。

应该使用哪个 API 和哪种模式？

下表汇总了在每种场景下应使用哪个 API 和哪种模式，使您无需阅读每个场景的细节即可选择正确的组合。

场景 / 用例	推荐的 API	使用的属性	备注
按源列名称添加筛选字段（最常用）	`PivotTable.addFieldToArea(PivotFieldType.Page, "fieldName")`	n/a	高级、一行代码。除非需要 `PivotField` 引用，否则请使用此方式。
当您已经拥有 `PivotField` 对象时添加筛选字段	`PivotTable.pageFields.add(PivotField)`	n/a	在字段对象是从其他位置获得或需要重用时使用。
筛选到单个筛选项（默认模式）	`PivotField.currentPageItem`	设置为具体索引	例如，`1` 显示已排序列表中的第二项。
显示所有项 / 清除筛选器	`PivotField.currentPageItem`	设置为 `0x7FFD`	特殊值 `0x7FFD`（十进制 32765）是“所有项”的哨兵值。
在 Excel 中启用多选 UI	`PivotField.isMultipleItemSelectionAllowed`	设置为 `true`	在任何 `isHidden` 调用生效之前必须设置。
在多选列表中隐藏 / 显示各个项	`PivotItem.isHidden`	按项设置	至少必须有一个项保持可见（`isHidden == false`）。

在配置多选筛选时，请始终牢记可见性约束。如果多选筛选字段中的每个 PivotItem 都被隐藏，Excel 在打开时会崩溃或渲染空白的数据透视表。请根据源数据构建白名单，以确保至少有一个项保持可见，这样您保存的工作簿将在每台机器上可靠地打开。

Nodejscpp: 从工作表中删除数据透视表

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++ 提供了从工作表中删除或移除数据透视表的功能。你可以使用数据透视表对象或其位置来删除数据透视表。请使用 Worksheet.getPivotTables().remove(pivotTable) 方法通过数据透视表对象删除，使用 Worksheet.getPivotTables().removeAt(index, keepData) 方法通过其在数据透视表集合中的位置删除。

如何使用 Aspose.Cells for Node.js via C++ 从工作表中删除数据透视表

以下示例代码从工作表中删除了两个数据透视表。首先使用Worksheet.getPivotTables().remove(pivotTable)方法移除数据透视表，然后使用Worksheet.getPivotTables().removeAt(index, keepData)方法移除数据透视表。

Nodejscpp: 将数据透视表保存为ODS文件

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Cells for Node.js via C++提供保存数据透视表为ODS文件的功能。只需转换含有现有数据透视表的工作簿，或新建数据透视表并以ODS格式保存即可。在保存前调用PivotTable.calculateData，确保数据透视表已渲染到输出的ODS文件中。以下代码演示了如何将数据透视表保存为ODS文件。

示例代码

上述代码生成的输出文件已附上供参考。

输出ODS文件

Documentation – 插入数据透视表

Nodejscpp: 格式化数据透视表

数据透视表外观

如何设置数据透视表格式选项

如何设置自动格式类型

如何设置格式选项

手动设置外观和感觉格式

如何设置数据透视表字段格式选项

如何设置行/列/页面字段格式

如何设置数据字段格式

如何清除数据透视字段

Nodejscpp: 创建数据透视表和数据透视图

使用Aspose.Cells for Node.js via C++添加数据透视表和图表

准备使用 Aspose.Cells for Node.js via C++

如何使用 Aspose.Cells for Node.js via C++ 添加数据透视表

如何使用 Aspose.Cells for Node.js via C++ 库添加数据透视图

Nodejscpp: 透视表和源数据

透视表的源数据

更改透视表的数据源

Nodejscpp: 在数据透视表中添加计算字段

可能的使用场景

如何在Excel中的数据透视表中添加计算字段

如何使用Aspose.Cells for Node.js via C++库在数据透视表中添加计算字段。

示例代码

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中刷新数据透视表

概述

所需的导入

刷新工作簿中的所有数据透视表

刷新单个工作表上的所有数据透视表

刷新单个数据透视表

源数据已更改 — 使用 PivotCache.Refresh()

仅视图/布局已更改 — 使用 CalculateData()

获取共享同一 PivotCache 的所有数据透视表

从过时的 PivotTable.RefreshData() 迁移

应该使用哪个刷新 API？

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中应用数据透视表样式

简介

应用旧式 XLS 预设自动格式

应用现代命名预设数据透视表样式

定义并应用自定义数据透视表样式

使用 FormatAll 将一个样式应用于数据透视表的每个单元格

我应该使用哪种样式 API？

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中添加数据透视表的行字段和列字段

向行或列区域添加字段

透视字段小计

场景 1 — 自动（默认）小计

场景 2 — 抑制所有小计 (None)

场景 3 — 自定义小计子集 (Sum + Average)

总结

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中管理数据透视表的值字段

Adding a Field to the Data Region

Changing the Summary Function

Plotting Value Fields to Row or Column Axis

Nodejscpp: 在 Aspose.Cells for Node.js via C++ 中向数据透视表添加筛选字段

简介

添加筛选字段

使用 addFieldToArea 添加筛选字段

使用 pageFields.add 添加筛选字段

单选筛选（显示一个筛选项）

显示所有项

显示一个特定项

多选筛选

应该使用哪个 API 和哪种模式？

Nodejscpp: 从工作表中删除数据透视表

如何使用 Aspose.Cells for Node.js via C++ 从工作表中删除数据透视表

Nodejscpp: 将数据透视表保存为ODS文件

示例代码

源数据已更改 — 使用 `PivotCache.Refresh()`

仅视图/布局已更改 — 使用 `CalculateData()`

从过时的 `PivotTable.RefreshData()` 迁移