WPS 加载项开发 > 表格 API 参考 > PivotTable > 方法 > PivotTable.AddDataField 方法
将数据字段添加到数据透视表中。返回一个 PivotField 对象,该对象表示新的数据字段。

语法

表达式.AddDataField(Field, Caption, Function)

表达式   一个代表 PivotTable 对象的变量。

参数

名称 必选/可选 数据类型 说明
Field 必选 Object 服务器上的唯一字段。如果源数据是联机分析处理 (OLAP)?(OLAP:为查询和报表(而不是处理事务)而进行了优化的数据库技术。OLAP 数据是按分级结构组织的,它存储在多维数据集而不是表中。),则唯一字段是多维数据集字段。如果源数据不是 OLAP(非 OLAP 源数据?(非 OLAP 源数据:非 OLAP 源数据是数据透视表或数据透视图使用的基本数据,该数据来自 OLAP 数据库之外的源。这些数据源包括关系数据库、 ET 工作表中的清单以及文本文件数据库。)),则唯一字段是数据透视表字段。
Caption 可选 Variant 数据透视表中使用的标签,用于识别该数据字段。
Function 可选 Variant 在已添加数据字段中执行的函数。

返回值
PivotField

示例

本示例将标题为“Total Score”的数据字段添加到名为“PivotTable1”的数据透视表中。

注释
本示例假定存在这样的表格,该表格中包含一个标题为“Score”的列。
示例代码
function AddMoreFields() {
    let pTab = ActiveSheet.PivotTables("PivotTable1")
    pTab.AddDataField(ActiveSheet.PivotTables("PivotTable1").PivotFields("Score"), "Total Score")
}


请参阅