Поделиться через

Чтение и запись в неограниченный диапазон с помощью API JavaScript для Excel

  • Статья

В этой статье описывается чтение и запись в неограниченный диапазон с помощью API JavaScript для Excel. Полный список свойств и методов, поддерживаемых объектом, см. в 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';

См. также