Freigeben über

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

Verwenden Sie diese Richtlinien, um zu verstehen, wie sich Adressen für ganze Spalten und ganze Zeilen verhalten, und wenden Sie Muster an, die Fehler und die Speicherauslastung reduzieren. Eine vollständige Liste der Eigenschaften und Methoden, die das Range Objekt unterstützt, finden Sie unter Excel.Range-Klasse.

Wichtige Punkte

  • "Unbounded" bezeichnet ganze Spalten (z A:F. B. ) oder ganze Zeilen (z 2:2. B. ).
  • Eigenschaften auf Zellenebene (z values. B. , text, numberFormatoder formulas) werden als für ungebundene Lesevorgänge zurückgegeben null .
  • Sie können keine Eigenschaften auf Zellenebene für einen unbegrenzten Bereich festlegen. Dadurch wird ein Fehler zurückgegeben.
  • Schränken Sie zuerst mit getUsedRange()auf die verwendeten Zellen ein.
  • Bevorzugen Sie explizite Begrenzungen (z A1:F5000. B. ) für schnellere Berechnungsgeschwindigkeiten und eine geringere Speicherauslastung.

Im Folgenden sind Beispiele für ungebundene Bereiche aufgeführt.

  • 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 Sie einen ungebundenen Bereich anfordern (z. BgetRange('C:C'). ), gibt die Antwort für Eigenschaften auf Zellenebene wie values, text, numberFormatund formulazurücknull. Andere Eigenschaften (address, cellCount) sind weiterhin gültig.

Schreibzugriff auf einen ungebundenen Bereich

Sie können Eigenschaften auf Zellenebene wie values, numberFormatoder formula nicht für einen unbegrenzten Bereich festlegen, da die Anforderung zu groß ist. Beispielsweise schlägt das nächste Codebeispiel fehl, da es für einen unbegrenzten Bereich festgelegt values wird.

// 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.

Nächste Schritte

Siehe auch

  • Last updated on