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 など、範囲のその他のプロパティには、無制限の範囲に有効な値が含まれます。

無制限の範囲への書き込み

入力要求が大きすぎるため、無制限の範囲で、、formulanumberFormat、などのvaluesセル レベルのプロパティを設定することはできません。 たとえば、次のコード例は、無制限の範囲の指定 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';

関連項目