Partekatu honen bidez:

Lectura o escritura en un intervalo sin enlazar mediante la API de JavaScript de Excel

Use estas instrucciones para comprender cómo se comportan las direcciones de columna completa y de fila completa, y aplicar patrones que reducen los errores y el uso de memoria. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea Clase Excel.Range.

Puntos clave

  • "Sin enlazar" significa columnas completas (como A:F) o filas completas (como 2:2).
  • Las propiedades de nivel de celda (como , , o formulas) vuelven como null para las lecturas sin numberFormatenlazar. textvalues
  • No se pueden establecer propiedades de nivel de celda en un rango sin enlazar. Esto devuelve un error.
  • Acotar primero a las celdas usadas con getUsedRange().
  • Prefiere límites explícitos (como A1:F5000) para velocidades de cálculo más rápidas y menor uso de memoria.

A continuación se muestran ejemplos de intervalos sin enlazar.

  • Direcciones de intervalo formadas por columnas completas.
    • C:C
    • A:F
  • Direcciones de intervalo formadas por filas completas.
    • 2:2
    • 1:4

Leer un rango sin delimitar

Cuando se solicita un rango sin enlazar (por ejemplo, getRange('C:C')), la respuesta devuelve null propiedades de nivel de celda como values, text, numberFormaty formula. Otras propiedades (address, cellCount) siguen siendo válidas.

Escribir en un rango sin delimitar

No se pueden establecer propiedades de nivel de celda como values, numberFormato formula en un intervalo sin enlazar porque la solicitud es demasiado grande. Por ejemplo, se produce un error en el siguiente ejemplo de código porque establece values para un intervalo sin enlazar.

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

Pasos siguientes

Vea también

  • Last updated on