Partilhar via

Ler ou escrever num intervalo não vinculado com a API JavaScript do Excel

Utilize estas diretrizes para compreender o comportamento dos endereços de coluna inteira e linha inteira e aplicar padrões que reduzem os erros e a utilização da memória. Para obter a lista completa de propriedades e métodos suportados pelo Range objeto, consulte Excel.Range class (Classe Excel.Range).

Principais pontos

  • "Não vinculado" significa colunas inteiras (como A:F) ou linhas inteiras (como 2:2).
  • As propriedades ao nível da célula (como values, text, numberFormatou formulas) voltam como null para leituras não vinculadas.
  • Não pode definir propriedades ao nível da célula num intervalo não vinculado. Isto devolve um erro.
  • Reduza para as células utilizadas primeiro com getUsedRange().
  • Prefira limites explícitos (como A1:F5000) para velocidades de cálculo mais rápidas e menor utilização da memória.

Seguem-se exemplos de intervalos não vinculados.

  • Endereços de intervalo compostos por colunas inteiras.
    • C:C
    • A:F
  • Endereços de intervalo compostos por linhas inteiras.
    • 2:2
    • 1:4

Ler um intervalo não limitado

Quando pede um intervalo não vinculado (por exemplo, getRange('C:C')), a resposta é devolvida null para propriedades ao nível da célula, como values, text, numberFormate formula. Outras propriedades (address, cellCount) ainda são válidas.

Gravar em um intervalo não limitado

Não pode definir propriedades ao nível da célula como values, numberFormatou formula num intervalo não vinculado porque o pedido é demasiado grande. Por exemplo, o exemplo de código seguinte falha porque define values para um intervalo não vinculado.

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

Próximas etapas

Confira também

  • Last updated on