Ler ou gravar em um intervalo não vinculado usando a API JavaScript do Excel

  • Artigo

Este artigo descreve como ler e gravar em um intervalo não vinculado com a API JavaScript do Excel. Para obter a lista completa de propriedades e métodos compatíveis com o Range objeto, consulte Classe Excel.Range.

Um endereço de intervalo não vinculado é um endereço de intervalo que especifica colunas inteiras ou linhas inteiras. Por exemplo:

  • 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 uma API faz uma solicitação para recuperar um intervalo não limitado (por exemplo, getRange('C:C')), a resposta conterá valores null para as propriedades no nível de célula, como values, text, numberFormat e formula. Outras propriedades do intervalo, como address e cellCount, conterão valores válidos para o intervalo não limitado.

Gravar em um intervalo não limitado

Você não pode definir propriedades no nível da célula, como values, numberFormate formula em um intervalo desvinculado porque a solicitação de entrada é muito grande. Por exemplo, o exemplo de código a seguir não é válido porque ele tenta especificar values para um intervalo não vinculado. A API retornará um erro se você tentar definir propriedades de nível de célula para um intervalo não vinculado.

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

Confira também