通过

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

  • 项目

本文介绍如何使用 Excel JavaScript API 读取和写入无限范围。 有关对象支持的属性和方法 Range 的完整列表，请参阅 Excel.Range 类。

无界范围地址是指定整列或整行的范围地址。 例如：

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

读取无限区域

API 发出请求以检索无限区域时（例如，getRange('C:C')），该响应将包含单元格级别属性（如 null、values、text 和 numberFormat）的 formula 值。 其他区域属性（如 address 和 cellCount）将包含无限区域的有效值。

写入一个无限区域

由于输入请求太大，因此不能在无界范围内设置单元级属性（如 values、 numberFormat和 formula ）。 例如，下面的代码示例无效，因为它尝试为无限范围指定 values 。 如果尝试为无限范围设置单元格级属性，API 将返回错误。

// Note: This code sample attempts to specify `values` for an unbounded range, which is not a valid request. The sample will return an error. 
let range = context.workbook.worksheets.getActiveWorksheet().getRange('A:B');
range.values = 'Due Date';

另请参阅