Office Scripts删除表格行报错：参数无效、缺失或格式错误

问题原因 #

原代码存在两个触发错误的场景：

1. 表格无数据行时参数无效：当目标表格只有表头、没有任何数据行时，table.getRangeBetweenHeaderAndTotal().getRowCount()会返回0。而deleteRowsAt方法的第二个参数（要删除的行数）必须是大于0的整数，传入0会直接触发参数无效错误。
2. 起始索引超出范围：deleteRowsAt的第一个参数是数据行的起始索引（数据行从0开始计数，表头不算在内）。如果表格只有1行数据，原代码传入起始索引1，这个位置不存在，同样会引发错误。

解决方法 #

根据你的需求，提供两种针对性的修改方案：

方案1：保留表头，删除所有数据行 #

如果需要仅保留表格表头，删除全部数据行，使用以下代码：

function main(workbook: ExcelScript.Workbook) {
  let sheet = workbook.getWorksheet('MySheet');
  let tables = sheet.getTables();

  tables.forEach((table) => {
    const dataRowCount = table.getRowCount();
    // 仅当存在数据行时执行删除
    if (dataRowCount > 0) {
      table.deleteRowsAt(0, dataRowCount);
    }
  });
}

方案2：保留表头和第一行数据，删除其余行 #

如果需要保留表头和第一行数据，删除剩下的所有数据行，使用以下代码：

function main(workbook: ExcelScript.Workbook) {
  let sheet = workbook.getWorksheet('MySheet');
  let tables = sheet.getTables();

  tables.forEach((table) => {
    const dataRowCount = table.getRowCount();
    // 仅当数据行数量大于1时，删除从索引1开始的剩余行
    if (dataRowCount > 1) {
      table.deleteRowsAt(1, dataRowCount - 1);
    }
  });
}

关键说明 #

• table.getRowCount()：直接返回表格的数据行数量（不包含表头和总计行），比通过范围获取行计数更准确可靠。
• 添加判断条件：避免在没有数据行或数据行数量不足时执行无效的删除操作，彻底解决参数错误问题。

内容的提问来源于stack exchange，提问作者user15235239