Office.TableData class

参考

包:: office

表示表或 Office.TableBinding 中的数据。

构造函数

(constructor)(rows, headers)	构造类的新实例`TableData`
(constructor)()	构造类的新实例`TableData`

属性

headers	获取或设置表的标题。
rows	获取或设置表中的行。返回包含表中数据的数组的数组。如果没有行，则返回空数组。

构造函数详细信息

(constructor)(rows, headers)

构造类的新实例TableData

constructor(rows: any[][], headers: any[]);

参数

rows: any[][]

headers: any[]

(constructor)()

构造类的新实例TableData

constructor();

属性详细信息

headers

获取或设置表的标题。

headers: any[];

属性值

any[]

注解

若要指定标题，你必须指定对应于表结构的数组的数组。例如，若要指定双列表的标头，请将标头属性设置为 [['header1'， 'header2']]。

如果在构造 tableData 对象) 时将标头属性指定为 null (或将属性留空，则执行代码时会出现以下结果。

如果插入新表，则将创建表的默认列标题。
如果覆盖或更新现有表，则不会改动现有标题。

示例

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}

rows

获取或设置表中的行。返回包含表中数据的数组的数组。如果没有行，则返回空数组。

rows: any[][];

属性值

any[][]

注解

若要指定行，则必须指定对应于表结构的数组的数组。例如，若要在两列表中指定两行字符串值，请将 rows 属性设置为 [['a'， 'b']， ['c'， 'd']]。

如果在构造 TableData 对象 () 时将行属性指定为 null 或将属性保留为空，则执行代码时会出现以下结果。

如果插入新表，将插入一个空白行。
如果覆盖或更新现有表，则不会改动现有行。

示例

// The following example creates a single-column table with a header and three rows.
function createTableData() {
    const tableData = new Office.TableData();
    tableData.headers = [['header1']];
    tableData.rows = [['row1'], ['row2'], ['row3']];
    return tableData;
}