type de ressource workbookTable

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente un tableau Excel.

Méthodes

Méthode Type renvoyé Description
List Collection WorkbookTable Obtenir une collection d’objets tableau.
Add WorkbookTable Crée un tableau. L’adresse de la source de la plage détermine la feuille de calcul dans laquelle le tableau sera ajouté. Si la table ne peut pas être ajoutée (par exemple, parce que l’adresse n’est pas valide ou qu’elle chevauche une autre table), une erreur est générée.
Obtenir WorkbookTable Lisez les propriétés et les relations de l’objet workbookTable.
Mettre à jour WorkbookTable Mettez à jour l’objet workbookTable.
Supprimer Aucun Supprime le tableau.
Répertorier des colonnes workbookTableColumn Obtenir une liste des objets workbookTableColumn.
Créer une colonne WorkbookTableColumn Créez un classeurTableColumn en le publiant dans la collection Columns.
Répertorier des lignes workbookTableRow collection Obtenir une collection d’objets workbookTableRow.
Créer une ligne WorkbookTableRow Créez un classeurTableRow en le publiant dans la collection de lignes.
Obtenir la plage du corps des données workbookRange Obtient l’objet workbookRange associé au corps de données de la table.
Obtenir la plage de lignes d’en-tête workbookRange Obtient l’objet workbookRange associé à la ligne d’en-tête de la table.
Obtenir la plage de la table workbookRange Récupère l’objet workbookRange associé à la table entière.
Obtenir la plage de lignes totale workbookRange Obtient l’objet workbookRange associé à la ligne des totaux de la table.
Effacer les filtres Aucun Supprime tous les filtres appliqués actuellement sur le tableau.
Convertir en plage workbookRange Convertit le tableau en plage normale de cellules. Toutes les données sont conservées.
Réappliquer des filtres Aucun Applique de nouveau tous les filtres actuellement appliqués sur le tableau.

Propriétés

Propriété Type Description
id string Identifiant unique de la table dans le classeur. La valeur de l’identificateur reste identique, même lorsque le tableau est renommé. Cette propriété doit être interprétée comme une valeur de chaîne opaque et ne doit pas être analysée pour un autre type. En lecture seule.
name string Nom de la table.
showHeaders Booléen Indique si la ligne d’en-tête est visible ou non. Cette valeur peut être définie de manière à afficher ou à masquer la ligne d’en-tête.
showTotals Booléen Indique si la ligne de total est visible ou non. Cette valeur peut être définie de manière à afficher ou à masquer la ligne de total.
style string Valeur constante qui représente le style Tableau. Les valeurs possibles sont : TableStyleLight1 à travers TableStyleLight21, TableStyleMedium1TableStyleStyleDark1 à travers TableStyleMedium28, à travers TableStyleStyleDark11. Vous pouvez également indiquer un style personnalisé présent dans le classeur.
highlightFirstColumn Boolean Indique si la première colonne contient une mise en forme spéciale.
highlightLastColumn Boolean Indique si la dernière colonne contient une mise en forme spéciale.
showBandedColumns Boolean Indique si les colonnes affichent une mise en forme à bandes dans laquelle la mise en évidence des colonnes impaires diffère de celle des colonnes paires pour faciliter la lecture du tableau.
showBandedRows Boolean Indique si les lignes affichent une mise en forme à bandes dans laquelle la mise en évidence des lignes impaires diffère de celle des lignes paires pour faciliter la lecture du tableau.
showFilterButton Boolean Indique si les boutons de filtre sont visibles dans la partie supérieure de chaque en-tête de colonne. Ce paramètre est autorisé uniquement si le tableau contient une ligne d’en-tête.
legacyId String Identificateur hérité utilisé dans les anciens clients Excel. La valeur de l’identificateur reste identique, même lorsque le tableau est renommé. Cette propriété doit être interprétée comme une valeur de chaîne opaque et ne doit pas être analysée pour un autre type. En lecture seule.

Relations

Relation Type Description
colonnes workbookTableColumn Liste de toutes les colonnes du tableau. En lecture seule.
Objet Rows workbookTableRow collection La liste de toutes les lignes du tableau. En lecture seule.
tri WorkbookTableSort Tri pour la table. En lecture seule.
worksheet WorkbookWorksheet Feuille de calcul contenant le tableau actif. En lecture seule.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "highlightFirstColumn": true,
  "highlightLastColumn": true,
  "id": "String (identifier)",
  "name": "String",
  "showBandedColumns": true,
  "showBandedRows": true,
  "showFilterButton": true,
  "showHeaders": true,
  "showTotals": true,
  "style": "String",
  "legacyId": "String"
}
  • Last updated on