type de ressource workbookTable

Espace de noms: microsoft.graph

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 que la table 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	collection workbookTableColumn	Obtenez la liste des objets workbookTableColumn.
Créer une colonne	WorkbookTableColumn	Créez un classeurTableColumn en publiant dans la collection columns.
Répertorier des lignes	collection workbookTableRow	Obtient une collection d’objets workbookTableRow.
Créer une ligne	WorkbookTableRow	Créez un classeurTableRow en publiant dans la collection rows.
Obtenir une plage de corps de 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 du tableau.
Obtenir une plage de tables	workbookRange	Obtient 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 les filtres	Aucun	Applique de nouveau tous les filtres actuellement appliqués sur le tableau.

Propriétés

Propriété	Type	Description
id	string	Identificateur 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 avec un autre type. En lecture seule.
name	string	Nom de la table.
showHeaders	Valeur booléenne	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	Valeur booléenne	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 les suivantes : TableStyleLight1 à , TableStyleLight21TableStyleMedium1 jusqu’à . TableStyleStyleDark1TableStyleMedium28TableStyleStyleDark11 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 clients Excel plus anciens. 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 avec un autre type. En lecture seule.

Relations

Relation	Type	Description
colonnes	collection workbookTableColumn	Liste de toutes les colonnes de la table. En lecture seule.
Objet Rows	collection workbookTableRow	Liste de toutes les lignes de la table. En lecture seule.
tri	WorkbookTableSort	Tri de 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"
}