Partager via

Lire ou écrire dans une plage non délimitée à l’aide de l’API JavaScript Excel

  • Article

Cet article explique comment lire et écrire dans une plage non liée avec l’API JavaScript Excel. Pour obtenir la liste complète des propriétés et méthodes prises en charge par l’objet Range , voir Classe Excel.Range.

Une adresse de plage non délimitée est une adresse de plage qui spécifie des colonnes entières ou des lignes entières. Par exemple :

  • Adresses de plage composées de colonnes entières.
    • C:C
    • A:F
  • Adresses de plage composées de lignes entières.
    • 2:2
    • 1:4

Lire une plage non liée

Lorsque l’API effectue une demande de récupération d’une plage non liée (par exemple, getRange('C:C')), la réponse contient des valeurs null pour les propriétés définies au niveau des cellules, telles que values, text, numberFormat et formula. Les autres propriétés de la plage, telles que address et cellCount, contiennent des valeurs valides pour la plage non liée.

Écrire dans une plage non liée

Vous ne pouvez pas définir des propriétés au niveau de la cellule telles que values, numberFormatet formula sur une plage non délimitée, car la demande d’entrée est trop volumineuse. Par exemple, l’exemple de code suivant n’est pas valide, car il tente de spécifier values pour une plage non délimitée. L’API retourne une erreur si vous tentez de définir des propriétés au niveau de la cellule pour une plage non délimitée.

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

Voir aussi