通过

使用 Excel JavaScript API 读取或写入无限范围

使用这些准则来了解整列和整行地址的行为方式，并应用减少错误和内存使用量的模式。 有关对象支持的属性和方法 Range 的完整列表，请参阅 Excel.Range 类。

要点

  • “Unbounded”是指整个列 (（如 A:F) ）或整行 (（如 2:2) ）。
  • 单元格级属性 (（如 values、 text、 numberFormat或 formulas) 作为无界读取）返回 null 。
  • 不能在无界区域中设置单元格级属性。 这会返回错误。
  • 先用 getUsedRange()缩小到使用的单元格。
  • 首选显式边界 (（如 A1:F5000) ）以加快计算速度和降低内存使用量。

下面是无限范围的示例。

  • 由整个列组成的范围地址。
    • C:C
    • A:F
  • 由整行组成的范围地址。
    • 2:2
    • 1:4

读取无限区域

当请求无限范围 (例如 getRange('C:C')) 时，响应将返回 null 单元格级属性，例如 values、 text、 numberFormat和 formula。 其他属性 (address， cellCount) 仍然有效。

写入一个无限区域

由于请求太大，因此不能在无限范围上设置单元级属性（如 values、 numberFormat或 formula ）。 例如，下一个代码示例失败，因为它为无界范围设置 values 。

// Invalid: Attempting to write cell-level data to unbounded columns.
let range = context.workbook.worksheets.getActiveWorksheet().getRange("A:B");
range.values = [["Due Date"]]; // This throws an error.

后续步骤

另请参阅