此页面由 Cloud Translation API 翻译。

Class DataTableBuilder

DataTable 对象的构建器。构建数据表的过程包括：先指定其列，然后逐一添加其行。示例：

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

方法

方法	返回类型	简介
`addColumn(type, label)`	`DataTableBuilder`	向数据表格添加列。
`addRow(values)`	`DataTableBuilder`	向数据表中添加一行。
`build()`	`DataTable`	构建并返回数据表格。
`setValue(row, column, value)`	`DataTableBuilder`	在表中设置特定值。

详细文档

`addColumn(type, label)`

向数据表格添加列。添加的列编号为 0 到 n。

图表通常会将第一列用作标签（例如，线图上的 X 轴标签或饼图中的切片标签）。其他列通常用于存储数据，因此通常需要数字值。

参数

名称	类型	说明
`type`	`ColumnType`	列中数据的类型（数字、字符串或日期）
`label`	`String`	列的标签（用于图表图例）。

DataTableBuilder - this 构建器，用于链式调用。

`addRow(values)`

向数据表中添加一行。

参数

名称	类型	说明
`values`	`Object[]`	行对应的值，按照输入列的顺序指定。

DataTableBuilder - this 构建器，用于链式调用。

`build()`

构建并返回数据表格。

DataTable - 数据表格

抛出

Error - 如果数据表为空或格式有误

`setValue(row, column, value)`

在表中设置特定值。

您可以在将列添加到数据表之前设置值。不过，除非您在某个时间点添加该列，否则系统会忽略该值。

并非所有列值都需要填写。缺失的值将被视为 null。

参数

名称	类型	说明
`row`	`Integer`	行索引（第一行索引为 0）
`column`	`Integer`	列索引（第一列的索引为 0）
`value`	`Object`	表格单元格的值（应为该列的正确类型）。

DataTableBuilder - this 构建器，用于链式调用