Lesen oder Schreiben in einen unbegrenzten Bereich mithilfe der Excel-JavaScript-API

  • Artikel

In diesem Artikel wird beschrieben, wie Sie mit der Excel-JavaScript-API einen ungebundenen Bereich lesen und in diesen schreiben. Eine vollständige Liste der Eigenschaften und Methoden, die das Range Objekt unterstützt, finden Sie unter Excel.Range-Klasse.

Eine ungebundene Bereichsadresse ist eine Bereichsadresse, die entweder ganze Spalten oder ganze Zeilen angibt. Beispiel:

  • Bereichsadressen, die aus ganzen Spalten bestehen.
    • C:C
    • A:F
  • Bereichsadressen, die aus ganzen Zeilen bestehen.
    • 2:2
    • 1:4

Lesen eines ungebundenen Bereichs

Wenn die API eine Anforderung zum Abrufen eines ungebundenen Bereichs (getRange('C:C')) ausführt, enthält die zurückgegebene Antwort null-Werte für Eigenschaften auf der Zellebene, wie z. B. values, text, numberFormat oder formula. Andere Eigenschaften des Bereichs, wie z. B. address und cellCount, enthalten gültige Werte für den ungebundenen Bereich.

Schreibzugriff auf einen ungebundenen Bereich

Eigenschaften auf Zellenebene wie values, numberFormatund formula können nicht für einen unbegrenzten Bereich festgelegt werden, da die Eingabeanforderung zu groß ist. Das folgende Codebeispiel ist beispielsweise ungültig, da es versucht, für einen unbegrenzten Bereich anzugeben values . Die API gibt einen Fehler zurück, wenn Sie versuchen, Eigenschaften auf Zellenebene für einen unbegrenzten Bereich festzulegen.

// 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';

Siehe auch