GetPivotByName

根据名称返回数据透视表，如果不存在则返回 null。

语法

expression.GetPivotByName(name);

expression - 表示 Api 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
name	必需	string		数据透视表名称。

返回值

ApiPivotTable | null

示例

按名称查找现有的数据透视表并在电子表格中向其添加字段。

// How do I find a pivot table by its title and configure its rows and values in a spreadsheet?

// Locate a summary table using its assigned name and populate it with data fields in a spreadsheet.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange('B1').SetValue('Region');
worksheet.GetRange('C1').SetValue('Price');
worksheet.GetRange('B2').SetValue('East');
worksheet.GetRange('B3').SetValue('West');
worksheet.GetRange('C2').SetValue(42.5);
worksheet.GetRange('C3').SetValue(35.2);

let dataRef = Api.GetRange("'Sheet1'!$B$1:$C$3");
let pivotTable = Api.InsertPivotNewWorksheet(dataRef);

Api.GetPivotByName(pivotTable.GetName()).AddFields({
    rows: 'Region',
});

Api.GetPivotByName(pivotTable.GetName()).AddDataField('Price');