Ler ou gravar em um intervalo não vinculado usando a API JavaScript do Excel
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
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.
Você não pode definir propriedades no nível da célula, como values
, numberFormat
e 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';
Comentários do Office Add-ins
O Office Add-ins é um projeto código aberto. Selecione um link para fornecer comentários: