Documentation – 插入数据透视表

Net: 格式化数据透视表

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

数据透视表外观

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

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

设置数据透视表格式选项

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

设置自动格式类型

Microsoft Excel提供多种不同的预设报告格式。Aspose.Cells也支持这些格式选项。要访问它们:

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

设置格式选项

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

手动设置外观和感觉格式

要手动设置数据透视表报告的外观格式，而不是使用预设的报告格式，请使用PivotTable.Format()和PivotTable.FormatAll()方法。为所需的格式创建一个样式对象，例如:

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

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

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

设置行/列/页字段格式

设置数据字段格式

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

清除数据透视字段

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

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

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

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

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

Aspose.Cells 支持数据透视表和数据透视图。

添加数据透视表和数据透视图

Aspose.Cells 提供了一组特殊的类，用于创建数据透视表。这些类用于创建和设置 PivotTable 对象，作为数据透视表对象的基本构建快：

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

准备使用Aspose.Cells

下载并安装 Aspose.Cells：
1. 下载 Aspose.Cells。
2. 在您的开发计算机上安装它。所有Aspose组件在安装后均处于评估模式。评估模式没有时间限制，只会在生成的文档中添加水印。若要充分发挥组件的功能，您需要有有效的许可证。
创建一个项目：
1. 启动 Visual Studio.Net。
2. 创建新的控制台应用程序。
添加引用：将Aspose.Cells组件的引用添加到项目中，例如…\ Program Files\ Aspose\ Aspose.Cells\ Bin\ Net1.0\ Aspose.Cells.dll

添加数据透视表

使用Aspose.Cells创建数据透视表：

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

下面是代码示例。

添加数据透视图

使用Aspose.Cells创建数据透视图：

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

Net: 透视表和源数据

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

透视表的源数据

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

更改透视表的数据源

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

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

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

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

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

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

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

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

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

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

可能的使用场景

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

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

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

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

通过C#在数据透视表中添加计算字段

使用Aspose.Cells向Excel文件中添加计算字段。请查看以下示例代码。执行示例代码后，数据透视表将添加一个带有计算字段的工作表。

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

示例代码

Net: 刷新 Aspose.Cells for .NET 中的数据透视表

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

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

简介

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

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

PivotCache.Refresh() — 在一次操作中重新加载源数据到缓存，并重新计算所有依赖的 PivotTable。
PivotTable.CalculateData() — 仅从已缓存的数据重新计算单个 PivotTable 的显示，不会往返访问数据源。本文中的所有场景都使用工作表单元格源数据，因此源类型为 Sheet，刷新操作按所述方式执行。

必需的 Using 指令

本文中的所有 C# 示例都以以下三个 using 指令开头，因为数据透视类型位于 Aspose.Cells.Pivot 命名空间中：

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

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

using Aspose.Cells;

Workbook workbook = new Workbook("input.xlsx");
workbook.RefreshAll();
workbook.Save("output.xlsx");

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

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

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 创建一个新的工作簿
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// 将表头行写入单元格 A1:C1
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 将数据行写入单元格 A2:C9（8 行水果数据，跨 2020 和 2021 年）
worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(50);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(60);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(70);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(80);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(90);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(100);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(110);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(120);

// 添加数据透视表：源区域 "A1:C9"，目标单元格 "E3"，名称 "Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

// 修改源数据中的若干 Amount 值以模拟更改
worksheet.Cells["C2"].PutValue(55);
worksheet.Cells["C5"].PutValue(85);
worksheet.Cells["C9"].PutValue(125);

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

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

刷新单个数据透视表

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

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

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

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

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

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("blueberry");
worksheet.Cells["B3"].PutValue(2021);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("cherry");
worksheet.Cells["B5"].PutValue(2021);
worksheet.Cells["C5"].PutValue(120);

worksheet.Cells["A6"].PutValue("grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(180);

worksheet.Cells["A7"].PutValue("blueberry");
worksheet.Cells["B7"].PutValue(2020);
worksheet.Cells["C7"].PutValue(130);

worksheet.Cells["A8"].PutValue("kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(220);

worksheet.Cells["A9"].PutValue("cherry");
worksheet.Cells["B9"].PutValue(2020);
worksheet.Cells["C9"].PutValue(140);

int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

worksheet.Cells["C2"].PutValue(300);
worksheet.Cells["C5"].PutValue(250);
worksheet.Cells["C9"].PutValue(400);

worksheet.RefreshPivotTables();

workbook.Save("output.xlsx");

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

如果源数据没有更改，但仅修改了数据透视表的视图或布局设置（例如，将字段移动到不同的区域，或切换了打开文件时刷新设置），则无需往返访问数据源。缓存已包含正确的数据；只需重新计算渲染后的 PivotTable。在这种情况下，pivotTable.CalculateData() 是正确的选择。这避免了不必要的源数据获取，当多个数据透视表共享同一缓存时速度显著提升。下面的示例修改数据透视表的非源属性，然后调用 CalculateData() 从现有缓存重新渲染它。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 创建新工作簿并访问第一个工作表
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// 写入表头行：Fruit / Year / Amount
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 写入大约 9 行数据（grape / blueberry / kiwi / cherry 横跨 2020-2021）
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

// 添加第一个数据透视表 "Pivot1"，锚定在单元格 E3，源数据范围为 A1:C9
int pivotIndex1 = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
PivotTable pivotTable1 = worksheet.PivotTables[pivotIndex1];

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

// 添加第二个数据透视表 "Pivot2"，锚定在 E15，使用相同的源数据范围 A1:C9
// 由于源数据范围相同，Pivot1 和 Pivot2 共享同一个 PivotCache
int pivotIndex2 = worksheet.PivotTables.Add("A1:C9", "E15", "Pivot2");
PivotTable pivotTable2 = worksheet.PivotTables[pivotIndex2];

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

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

// 刷新共享的 PivotCache
// 由于 Pivot1 和 Pivot2 共享同一个 PivotCache，这一个调用
// 即可刷新两个数据透视表（数据 + 样式），使其来源于更新后的数据
pivotTable1.PivotCache.Refresh();

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

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

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

using Aspose.Cells;
using Aspose.Cells.Pivot;

var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];

// 写入 Fruit / Year / Amount 表头行
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 写入 8 行数据（第 2-9 行，符合源数据范围 A1:C9）
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(150);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(250);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(350);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(450);

// 添加一个名为 "Pivot1" 的数据透视表，放置在目标单元格 E3，数据源为 A1:C9
int pivotIndex = worksheet.PivotTables.Add("A1:C9", "E3", "Pivot1");
var pivotTable = worksheet.PivotTables[pivotIndex];

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

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

// CalculateData() 从 PivotCache 中已有的数据重新呈现此数据透视表的显示（数据 + 样式）。因为源数据未发生变化，
// 所以不会执行与源数据的往返 —— 仅将缓存的值重新计算到工作表单元格中。
pivotTable.CalculateData();

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

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

在 Aspose.Cells for .NET v26.7 之前，刷新数据透视表的标准方式是对每个数据透视表单独调用 PivotTable.RefreshData()。从 v26.7 开始，该方法被标记为过时，应替换为上述感知缓存的 API。在真实场景的工作簿中，按表调用的 RefreshData() 方法存在两个问题：

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

应该使用哪种刷新 API？

下表总结了可用的刷新 API 以及每种 API 的适用场景。

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

Net: 在 Aspose.Cells for .NET 中应用数据透视表样式

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 的二维布局而设计。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

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

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

// 获取第一个工作表
Worksheet sheet = workbook.Worksheets[0];

// 填充源数据，包含表头行（Fruit、Year、Amount）
// 以及 9 行数据，涵盖 2020 和 2021 年的 grape、blueberry、kiwi、cherry
sheet.Cells[0, 0].PutValue("Fruit");
sheet.Cells[0, 1].PutValue("Year");
sheet.Cells[0, 2].PutValue("Amount");

sheet.Cells[1, 0].PutValue("grape");
sheet.Cells[1, 1].PutValue(2020);
sheet.Cells[1, 2].PutValue(50);

sheet.Cells[2, 0].PutValue("blueberry");
sheet.Cells[2, 1].PutValue(2020);
sheet.Cells[2, 2].PutValue(30);

sheet.Cells[3, 0].PutValue("kiwi");
sheet.Cells[3, 1].PutValue(2020);
sheet.Cells[3, 2].PutValue(25);

sheet.Cells[4, 0].PutValue("cherry");
sheet.Cells[4, 1].PutValue(2020);
sheet.Cells[4, 2].PutValue(40);

sheet.Cells[5, 0].PutValue("grape");
sheet.Cells[5, 1].PutValue(2021);
sheet.Cells[5, 2].PutValue(60);

sheet.Cells[6, 0].PutValue("blueberry");
sheet.Cells[6, 1].PutValue(2021);
sheet.Cells[6, 2].PutValue(35);

sheet.Cells[7, 0].PutValue("kiwi");
sheet.Cells[7, 1].PutValue(2021);
sheet.Cells[7, 2].PutValue(28);

sheet.Cells[8, 0].PutValue("cherry");
sheet.Cells[8, 1].PutValue(2021);
sheet.Cells[8, 2].PutValue(45);

sheet.Cells[9, 0].PutValue("grape");
sheet.Cells[9, 1].PutValue(2020);
sheet.Cells[9, 2].PutValue(45);

// 在目标单元格 E3 添加一个名为 "Pivot1" 的数据透视表，使用源区域 A1:C10
int pivotIndex = sheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

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

// 应用旧的 XLS 预设自动格式 "Report5"
// 注意：此属性仅在另存为 .xls 时有效。
// 当另存为 .xlsx/.xlsm/.xlsb 时，Excel 会忽略 AutoFormatType，
// 并使用 PivotTableStyleType / PivotTableStyleName 所指定的样式。
pivotTable.AutoFormatType = 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。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 场景 2:使用 PivotTableStyleType 应用现代 Excel 2007+ 命名预设样式。
// 目标文件格式:.xlsx。PivotTableStyleType 枚举位于 Aspose.Cells 命名空间中
// (不在 Aspose.Cells.Pivot 中) —— 这就是为什么我们不需要任何额外的 using 语句。
// GitHub 参考:https://github.com/aspose-cells/Aspose.Cells-for-.NET/blob/master/Examples/CSharp/PivotTables/ApplyStyleToPivotTable2.cs

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// 表头行:Fruit / Year / Amount
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 9 行 Fruit / Year / Amount 数据
worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(150);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(200);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(180);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(120);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(170);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(210);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(190);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(130);

// 在 E3 添加一个名为 "Pivot1" 的数据透视表,数据源为 A1:C10
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

// 应用现代 Excel 2007+ 命名预设数据透视样式。
// PivotTableStyleType 是适用于 .xlsx / .xlsm / .xlsb 文件的正确 API;AutoFormatType
// 在这些格式中会被 Excel 忽略。PivotTableStyleDark1 属于深色主题
// 系列(PivotTableStyleDark1..PivotTableStyleDark28),同一枚举还公开了
// 较新的 Excel 2017 浅色/深色主题(PivotTableStyleLight1..Light28 / Dark1..Dark28)。
pivotTable.PivotTableStyleType = 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，对通过 AddPivotTableStyle 定义的自定义样式使用 PivotTableStyleName。同时设置两者没有害处，但只有与预期来源匹配的那一个会被呈现。

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

以下示例定义了一个自定义数据透视表样式，在 WholeTable 上使用细黑色边框，在 GrandTotalRow 上使用粗体红色字体，然后通过 PivotTableStyleName 应用该样式，并保存为 .xlsx。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;
using System.Drawing;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// 填充源数据：表头行 + 9 行数据 (A1:C10)
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(100);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(200);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(300);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(400);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(500);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(600);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(700);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(800);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(900);

// 添加数据源为 A1:C10 的数据透视表，锚定在 E3，命名为 "Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

// 第 1 步：注册一个新的自定义数据透视表样式并获取其索引
int styleIndex = workbook.Worksheets.TableStyles.AddPivotTableStyle("CustomPivotStyle");
TableStyle tableStyle = workbook.Worksheets.TableStyles[styleIndex];

// 第 2 步：添加 WholeTable 元素，并在四边应用细黑色边框
int wholeTableElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.WholeTable);
TableStyleElement wholeTableElement = tableStyle.TableStyleElements[wholeTableElementIndex];
Style wholeTableStyle = workbook.CreateStyle();
wholeTableStyle.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.TopBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.BottomBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.LeftBorder].Color = Color.Black;
wholeTableStyle.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
wholeTableStyle.Borders[BorderType.RightBorder].Color = Color.Black;
wholeTableElement.SetElementStyle(wholeTableStyle);

// 第 3 步：添加 GrandTotalRow 元素，并应用粗体红色字体
int grandTotalElementIndex = tableStyle.TableStyleElements.Add(TableStyleElementType.GrandTotalRow);
TableStyleElement grandTotalElement = tableStyle.TableStyleElements[grandTotalElementIndex];
Style grandTotalStyle = workbook.CreateStyle();
grandTotalStyle.Font.IsBold = true;
grandTotalStyle.Font.Color = Color.Red;
grandTotalElement.SetElementStyle(grandTotalStyle);

// 第 4 步：通过名称应用自定义样式（不是通过 PivotTableStyleType，那是用于内置预设的）
pivotTable.PivotTableStyleName = "CustomPivotStyle";

workbook.Save("output.xlsx");

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

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

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

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

using System;
using System.Drawing;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 场景4：使用FormatAll将单个Style应用于每个数据透视表单元格
// 使用的API：PivotTable.FormatAll(Style)
// 目标格式：.xlsx
// GitHub参考：请参阅Aspose.Cells-for-.NET存储库 — 数据透视表样式示例

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];

// 填充源数据：标题行（第1行）+ 9个数据行（第2-10行）
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

worksheet.Cells["A2"].PutValue("Grape");
worksheet.Cells["B2"].PutValue(2020);
worksheet.Cells["C2"].PutValue(5000);

worksheet.Cells["A3"].PutValue("Blueberry");
worksheet.Cells["B3"].PutValue(2020);
worksheet.Cells["C3"].PutValue(3000);

worksheet.Cells["A4"].PutValue("Kiwi");
worksheet.Cells["B4"].PutValue(2020);
worksheet.Cells["C4"].PutValue(4000);

worksheet.Cells["A5"].PutValue("Cherry");
worksheet.Cells["B5"].PutValue(2020);
worksheet.Cells["C5"].PutValue(2000);

worksheet.Cells["A6"].PutValue("Grape");
worksheet.Cells["B6"].PutValue(2021);
worksheet.Cells["C6"].PutValue(6000);

worksheet.Cells["A7"].PutValue("Blueberry");
worksheet.Cells["B7"].PutValue(2021);
worksheet.Cells["C7"].PutValue(3500);

worksheet.Cells["A8"].PutValue("Kiwi");
worksheet.Cells["B8"].PutValue(2021);
worksheet.Cells["C8"].PutValue(4500);

worksheet.Cells["A9"].PutValue("Cherry");
worksheet.Cells["B9"].PutValue(2021);
worksheet.Cells["C9"].PutValue(2500);

worksheet.Cells["A10"].PutValue("Grape");
worksheet.Cells["B10"].PutValue(2021);
worksheet.Cells["C10"].PutValue(5500);

// 添加数据透视表：源区域A1:C10，目标单元格E3，名称"Pivot1"
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "Pivot1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

// 构建一个将强制应用于数据透视表每个单元格的Style
Style style = workbook.CreateStyle();
style.ForegroundColor = Color.Yellow;
style.Pattern = BackgroundType.Solid;
style.Font.IsBold = true;
style.Font.Color = Color.DarkBlue;
style.Borders[BorderType.TopBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.TopBorder].Color = Color.Black;
style.Borders[BorderType.BottomBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.BottomBorder].Color = Color.Black;
style.Borders[BorderType.LeftBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.LeftBorder].Color = Color.Black;
style.Borders[BorderType.RightBorder].LineStyle = CellBorderType.Thin;
style.Borders[BorderType.RightBorder].Color = 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。

Net: 在 Aspose.Cells for .NET 中添加数据透视表的行字段和列字段

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) 来明确确认此行为。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Automatic, true);

pivotTable.CalculateData();

workbook.Save("output_automatic.xlsx");

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

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

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

string[] headers = { "Category", "Item", "Year", "Amount" };
for (int j = 0; j < headers.Length; j++)
{
    worksheet.Cells[0, j].PutValue(headers[j]);
}

object[,] 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 (int i = 0; i < data.GetLength(0); i++)
{
    for (int j = 0; j < data.GetLength(1); j++)
    {
        worksheet.Cells[i + 1, j].PutValue(data[i, j]);
    }
}

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.None, true);
pivotTable.CalculateData();

workbook.Save("output_none.xlsx");

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

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

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells["A1"].PutValue("Category");
worksheet.Cells["B1"].PutValue("Item");
worksheet.Cells["C1"].PutValue("Year");
worksheet.Cells["D1"].PutValue("Amount");

worksheet.Cells[1, 0].PutValue("Fruit");
worksheet.Cells[1, 1].PutValue("Apple");
worksheet.Cells[1, 2].PutValue(2020);
worksheet.Cells[1, 3].PutValue(100);

worksheet.Cells[2, 0].PutValue("Fruit");
worksheet.Cells[2, 1].PutValue("Apple");
worksheet.Cells[2, 2].PutValue(2021);
worksheet.Cells[2, 3].PutValue(150);

worksheet.Cells[3, 0].PutValue("Fruit");
worksheet.Cells[3, 1].PutValue("Banana");
worksheet.Cells[3, 2].PutValue(2020);
worksheet.Cells[3, 3].PutValue(80);

worksheet.Cells[4, 0].PutValue("Fruit");
worksheet.Cells[4, 1].PutValue("Banana");
worksheet.Cells[4, 2].PutValue(2021);
worksheet.Cells[4, 3].PutValue(90);

worksheet.Cells[5, 0].PutValue("Vegetable");
worksheet.Cells[5, 1].PutValue("Carrot");
worksheet.Cells[5, 2].PutValue(2020);
worksheet.Cells[5, 3].PutValue(50);

worksheet.Cells[6, 0].PutValue("Vegetable");
worksheet.Cells[6, 1].PutValue("Carrot");
worksheet.Cells[6, 2].PutValue(2021);
worksheet.Cells[6, 3].PutValue(60);

worksheet.Cells[7, 0].PutValue("Vegetable");
worksheet.Cells[7, 1].PutValue("Daikon");
worksheet.Cells[7, 2].PutValue(2020);
worksheet.Cells[7, 3].PutValue(40);

worksheet.Cells[8, 0].PutValue("Vegetable");
worksheet.Cells[8, 1].PutValue("Daikon");
worksheet.Cells[8, 2].PutValue(2021);
worksheet.Cells[8, 3].PutValue(45);

PivotTableCollection pivotTables = worksheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = pivotTables[pivotIndex];

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

PivotField categoryField = pivotTable.RowFields[0];
categoryField.SetSubtotals(PivotFieldSubtotalType.Sum, true);
categoryField.SetSubtotals(PivotFieldSubtotalType.Average, true);

pivotTable.CalculateData();

workbook.Save("output_custom.xlsx");

小结

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

Net: 在 Aspose.Cells for .NET 中管理数据透视表的值字段

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

将字段添加到数据区域

将基础字段添加到数据（值）区域是塑造数据透视表如何聚合源数据的第一步。Aspose.Cells 公开了 PivotTable.AddFieldToArea(PivotFieldType, string) 重载方法，该方法接受常量 PivotFieldType.Data 和源列名称。一旦字段被添加到数据区域，就可以通过 PivotTable.DataFields 集合按字段添加的顺序访问它。默认情况下，数值类型的源列使用 ConsolidationFunction.Sum 进行汇总，而非数值列默认使用 Count。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// A1:D1 中的标题行
worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

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

// 在 F3 位置添加名为 PivotTable1 的数据透视表
int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

pivotTable.CalculateData();
workbook.Save("output_drag.xlsx");

更改汇总函数

放置在数据区域中的每个字段在内部都被包装为一个 PivotField 实例，其 Function 属性返回 ConsolidationFunction 枚举中的一个值。相同的 Function setter 允许您在可用的聚合之间切换，包括 Sum、Count、Average、Max、Min、Product、StdDev、StdDevp、Var 和 Varp。

更改 Function 仅影响聚合方式，源列不会改变。

因此，您可以让一个数据字段保持为 Sum，同时添加一个针对同一源列但使用 Count 或 Average 的第二个数据字段，所有这些都在同一个数据透视表中完成。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

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

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

PivotField countField = pivotTable.DataFields[1];
countField.Function = ConsolidationFunction.Count;

pivotTable.CalculateData();

workbook.Save("output_function.xlsx");

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

当数据透视表包含两个或多个数据字段时，Aspose.Cells 会公开一个额外的虚拟字段，称为 PivotTable.ValuesField。此虚拟字段表示数据区域中每个数据字段的聚合结果。您可以将其作为基础数据透视字段拖入行区域或列区域，这对于将多个度量值并排布局非常有用。

如果没有值字段或只有一个值字段，则 PivotTable.ValuesField 无法使用。

下面的场景演示了三个端到端示例，针对相同的数据透视结构展示了上文描述的每项功能。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

Workbook workbook = new Workbook();
Worksheet worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

worksheet.Cells[0, 0].PutValue("Category");
worksheet.Cells[0, 1].PutValue("Item");
worksheet.Cells[0, 2].PutValue("Year");
worksheet.Cells[0, 3].PutValue("Amount");

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

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

int pivotIndex = worksheet.PivotTables.Add("A1:D9", "F3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

pivotTable.DataFields[1].Function = ConsolidationFunction.Count;

pivotTable.AddFieldToArea(PivotFieldType.Column, pivotTable.ValuesField.Name);

pivotTable.CalculateData();
workbook.Save("output_plot.xlsx");

Net: 在 Aspose.Cells for .NET 中向数据透视表添加筛选字段

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 .NET 提供了两种等效的方式来注册筛选字段。高级 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 位于筛选区域，刷新数据透视表并保存工作簿。

using System;
using System.IO;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 创建一个新的工作簿
var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];
worksheet.Name = "Data";

// 设置表头行
worksheet.Cells["A1"].PutValue("Fruit");
worksheet.Cells["B1"].PutValue("Year");
worksheet.Cells["C1"].PutValue("Amount");

// 填充 9 行示例数据：水果、年份、数量
object[,] data = new object[,]
{
    { "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 (int i = 0; i < data.GetLength(0); i++)
{
    worksheet.Cells[i + 1, 0].PutValue(data[i, 0]);
    worksheet.Cells[i + 1, 1].PutValue(data[i, 1]);
    worksheet.Cells[i + 1, 2].PutValue(data[i, 2]);
}

// 在单元格 E3 处添加数据透视表
int pivotIndex = worksheet.PivotTables.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = worksheet.PivotTables[pivotIndex];

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

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

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

使用 PageFields.Add 添加筛选字段

当您已经处理 PivotField 实例时，可以将其直接传递给 PivotTable.PageFields.Add。数据透视表和筛选字段的构建方式与前面的场景完全相同；只是最后的筛选区域注册被替换为较低级别的 API 调用。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — 透视表和页面字段的构建方式与场景 1a 完全相同
//   （Fruit/Year/Amount 数据，透视表位于 E3，Fruit→行，
//   Amount→数据）。下面我们从 BaseFields 集合中
//   获取 Year PivotField，并将其传递给 PageFields.Add —
//   这是 AddFieldToArea 的低级替代方案。其结果
//   在功能上与场景 1a 相同。

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

// 表头
sheet.Cells["A1"].PutValue("Fruit");
sheet.Cells["B1"].PutValue("Year");
sheet.Cells["C1"].PutValue("Amount");

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

// 在 E3 处添加透视表，覆盖 A1:C10
int pivotIndex = sheet.PivotTables.Add("E3", "A1:C10", "PivotTable1");
PivotTable pivotTable = sheet.PivotTables[pivotIndex];

// Fruit → 行，Amount → 数据（Year 将进入下面的 Page 区域）
pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");

// 底层方法：从 BaseFields 中获取现有的 Year PivotField，
// 并通过 PageFields.Add(PivotField) 将其注册到 Page 区域。
PivotField yearField = pivotTable.BaseFields["Year"];
pivotTable.PageFields.Add(yearField);

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

workbook.Save("output.xlsx");

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

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

显示所有项

将 CurrentPageItem 设置为魔术值 0x7FFD 等同于清除筛选器：数据透视主体会汇总所有筛选项，就像未应用任何筛选器一样。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

class Program
{
    static void Main()
    {
        // 创建一个新的工作簿
        Workbook workbook = new Workbook();
        Worksheet sheet = workbook.Worksheets[0];

        // 填充 Fruit/Year/Amount 数据
        sheet.Cells["A1"].PutValue("Fruit");
        sheet.Cells["B1"].PutValue("Year");
        sheet.Cells["C1"].PutValue("Amount");

        object[,] data = new object[,]
        {
            {"Apple", 2022, 100},
            {"Apple", 2023, 150},
            {"Banana", 2022, 80},
            {"Banana", 2023, 120},
            {"Cherry", 2022, 200},
            {"Cherry", 2023, 250}
        };

        for (int r = 0; r < data.GetLength(0); r++)
        {
            for (int c = 0; c < data.GetLength(1); c++)
            {
                sheet.Cells[r + 1, c].PutValue(data[r, c]);
            }
        }

        // 在 E3 创建数据透视表
        var pivotTables = sheet.PivotTables;
        int index = pivotTables.Add("=A1:C7", "E3", "PivotTable1");
        PivotTable pivotTable = pivotTables[index];

        // 配置数据透视字段:Fruit→行,Amount→数据,Year→页
        pivotTable.AddFieldToArea(PivotFieldType.Row, "Fruit");
        pivotTable.AddFieldToArea(PivotFieldType.Data, "Amount");
        pivotTable.AddFieldToArea(PivotFieldType.Page, "Year");

        pivotTable.CalculateData();

        // 清除页面筛选器,以便页面字段中的每个项都可见。
        // 0x7FFD(十进制 32765)是表示"所有项"的特殊哨兵值 —
        // 相当于在 Excel 的页字段下拉菜单中选择"(全部)"。
        pivotTable.PageFields[0].CurrentPageItem = 0x7FFD;

        workbook.Save("output.xlsx");
    }
}

显示一个特定项

将 CurrentPageItem 设置为真实索引将仅选择该单个筛选项。该索引是筛选字段排序项列表中项的位置，因此例如 1 选择排序后的第二个项。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// 创建工作簿
var workbook = new Workbook();
var sheet = workbook.Worksheets[0];
var cells = sheet.Cells;

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

cells["A2"].PutValue("Apple");
cells["B2"].PutValue("2020");
cells["C2"].PutValue("100");

cells["A3"].PutValue("Apple");
cells["B3"].PutValue("2021");
cells["C3"].PutValue("150");

cells["A4"].PutValue("Banana");
cells["B4"].PutValue("2020");
cells["C4"].PutValue("200");

cells["A5"].PutValue("Banana");
cells["B5"].PutValue("2021");
cells["C5"].PutValue("250");

// 在 E3 处添加数据透视表
var pivotTables = sheet.PivotTables;
int pivotIndex = pivotTables.Add("A1:C5", "E3", "PivotTable1");
var pivotTable = pivotTables[pivotIndex];

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

// 页字段特定操作
pivotTable.PageFields[0].CurrentPageItem = 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()) 块将您选择的源值加入白名单并隐藏所有其他项。

using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;

// — 透视表和页面字段的构建方式与场景 1a 完全相同
//   （Fruit/Year/Amount 数据，透视表位于 E3，Fruit→行，
//   Amount→数据，Year→页面（通过 AddFieldToArea））。
//   下面我们对页面字段应用多选筛选。

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;

// 示例数据：Fruit | Year | Amount
cells[0, 0].PutValue("Fruit");
cells[0, 1].PutValue("Year");
cells[0, 2].PutValue("Amount");

string[,] data = new string[,]
{
    { "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 (int i = 0; i < data.GetLength(0); i++)
{
    cells[i + 1, 0].PutValue(data[i, 0]);
    cells[i + 1, 1].PutValue(Convert.ToInt32(data[i, 1]));
    cells[i + 1, 2].PutValue(Convert.ToInt32(data[i, 2]));
}

Worksheet pivotSheet = workbook.Worksheets.Add("Pivot");
PivotTableCollection pivots = pivotSheet.PivotTables;
int pivotIndex = pivots.Add("A1:C10", "E3", "PivotTable1");
PivotTable pivotTable = pivots[pivotIndex];

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

// — 在页面字段上启用多选
pivotTable.PageFields[0].IsMultipleItemSelectionAllowed = true;

// A 部分 — 选择所有项（使每个项都可见）
PivotItemCollection pivotItems = pivotTable.PageFields[0].PivotItems;
for (int i = 0; i < pivotItems.Count; i++)
{
    pivotItems[i].IsHidden = false;
}

// B 部分 — 仅按源值选择特定的项
for (int i = 0; i < pivotItems.Count; i++)
{
    switch (pivotItems[i].GetStringValue())
    {
        case "2020":
        case "grape":
        case "blueberry":
            pivotItems[i].IsHidden = false;
            break;
        default:
            pivotItems[i].IsHidden = 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 在打开时会崩溃或呈现空白的数据透视表。针对您的源数据构建白名单，确保至少有一个项保持可见，这样保存的工作簿将在每台机器上可靠打开。

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

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

Aspose.Cells提供了一个功能，用于删除或移除工作表中的数据透视表。您可以使用数据透视表对象或数据透视表位置来删除数据透视表。请使用Worksheet.PivotTables.Remove()方法使用数据透视表对象来删除数据透视表，使用其位置在数据透视表集合内Worksheet.PivotTables.RemoveAt()方法删除数据透视表对象。

以下示例代码从工作表中删除了两个数据透视表。首先使用Worksheet.PivotTables.Remove()方法移除数据透视表，然后使用Worksheet.PivotTables.RemoveAt()方法移除数据透视表。

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

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

Aspose.Cells支持将数据透视表保存为ODS文件。为此，您只需将具有现有数据透视表的工作簿转换或创建新的数据透视表，并将文件保存为ODS格式。在保存之前确保调用PivotTable.CalculateData()以确保数据透视表在输出ODS文件中呈现。以下代码片段演示了将数据透视表保存为ODS文件。

示例代码

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

输出ODS文件

Documentation – 插入数据透视表

Net: 格式化数据透视表

数据透视表外观

设置数据透视表格式选项

设置自动格式类型

设置格式选项

手动设置外观和感觉格式

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

设置行/列/页字段格式

设置数据字段格式

清除数据透视字段

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

添加数据透视表和数据透视图

准备使用Aspose.Cells

添加数据透视表

添加数据透视图

Net: 透视表和源数据

透视表的源数据

更改透视表的数据源

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

可能的使用场景

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

通过C#在数据透视表中添加计算字段

示例代码

Net: 刷新 Aspose.Cells for .NET 中的数据透视表

简介

必需的 Using 指令

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

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

刷新单个数据透视表

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

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

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

从过时的 PivotTable.RefreshData() 迁移

应该使用哪种刷新 API？

Net: 在 Aspose.Cells for .NET 中应用数据透视表样式

简介

应用旧版 XLS 预设自动格式

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

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

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

我应该使用哪种样式 API？

Net: 在 Aspose.Cells for .NET 中添加数据透视表的行字段和列字段

向行区域或列区域添加字段

数据透视字段小计

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

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

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

小结

Net: 在 Aspose.Cells for .NET 中管理数据透视表的值字段

将字段添加到数据区域

更改汇总函数

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

Net: 在 Aspose.Cells for .NET 中向数据透视表添加筛选字段

介绍

添加筛选字段

使用 AddFieldToArea 添加筛选字段

使用 PageFields.Add 添加筛选字段

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

显示所有项

显示一个特定项

多选过滤

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

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

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

示例代码

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

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

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