Compartir a través de

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

  • Artículo

En este artículo se describe cómo leer y escribir en un intervalo sin enlazar con la API de JavaScript de Excel. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea Clase Excel.Range.

Una dirección de intervalo sin enlazar es una dirección de intervalo que especifica columnas completas o filas completas. Por ejemplo:

  • 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 la API realiza una solicitud para recuperar un intervalo sin delimitar (por ejemplo, getRange('C:C')), la respuesta contendrá valores null para las propiedades de nivel de celda, como values, text, numberFormat y formula. Otras propiedades del rango, como address y cellCount, contendrán los valores válidos para el intervalo ilimitado.

Escribir en un rango sin delimitar

No se pueden establecer propiedades de nivel de celda como values, numberFormaty formula en un intervalo sin enlazar porque la solicitud de entrada es demasiado grande. Por ejemplo, el siguiente ejemplo de código no es válido porque intenta especificar values para un intervalo sin enlazar. La API devuelve un error si intenta establecer las propiedades de nivel de celda para un intervalo sin enlazar.

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

Vea también