Excel.Interfaces.TableRowLoadOptions interface

Représente une ligne dans un tableau.

Notez que, contrairement aux plages ou colonnes, qui s’ajustent si de nouvelles lignes ou colonnes sont ajoutées avant elles, un TableRow objet représente l’emplacement physique de la ligne du tableau, mais pas les données. En d’autres termes, si les données sont triées ou si de nouvelles lignes sont ajoutées, une ligne de tableau continue à pointer vers l’index pour lequel elle a été créée.

Propriétés

$all

La spécification $all des options de chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

index

Renvoie le numéro d’indice de la ligne dans la collection de lignes du tableau. Avec indice zéro.

values

Représente les valeurs brutes de la plage spécifiée. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur. Si la valeur renvoyée commence par un plus (« + »), moins (« - ») ou un signe égal (« = »), Excel interprète cette valeur comme une formule.

valuesAsJson

Représentation JSON des valeurs des cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJson prend en charge tous les types de données pouvant se trouver dans une cellule. Par exemple, des valeurs numériques mises en forme et des images web, en plus des valeurs booléennes, numériques et de chaîne standard. Les données renvoyées à partir de cette API s’alignent toujours sur les paramètres régionaux fr-FR. Pour récupérer des données dans les paramètres régionaux d’affichage de l’utilisateur, utilisez TableRow.valuesAsJsonLocal.

valuesAsJsonLocal

Représentation JSON des valeurs des cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJsonLocal prend en charge tous les types de données pouvant se trouver dans une cellule. Par exemple, des valeurs numériques mises en forme et des images web, en plus des valeurs booléennes, numériques et de chaîne standard. Les données renvoyées par cette API s’alignent toujours sur les paramètres régionaux d’affichage de l’utilisateur. Pour récupérer des données indépendamment des paramètres régionaux, utilisez TableRow.valuesAsJson.

Détails de la propriété

$all

La spécification $all des options de chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

$all?: boolean;

Valeur de propriété

boolean

index

Renvoie le numéro d’indice de la ligne dans la collection de lignes du tableau. Avec indice zéro.

index?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.1

values

Représente les valeurs brutes de la plage spécifiée. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur. Si la valeur renvoyée commence par un plus (« + »), moins (« - ») ou un signe égal (« = »), Excel interprète cette valeur comme une formule.

values?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.1

valuesAsJson

Représentation JSON des valeurs des cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJson prend en charge tous les types de données pouvant se trouver dans une cellule. Par exemple, des valeurs numériques mises en forme et des images web, en plus des valeurs booléennes, numériques et de chaîne standard. Les données renvoyées à partir de cette API s’alignent toujours sur les paramètres régionaux fr-FR. Pour récupérer des données dans les paramètres régionaux d’affichage de l’utilisateur, utilisez TableRow.valuesAsJsonLocal.

valuesAsJson?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.16

valuesAsJsonLocal

Représentation JSON des valeurs des cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJsonLocal prend en charge tous les types de données pouvant se trouver dans une cellule. Par exemple, des valeurs numériques mises en forme et des images web, en plus des valeurs booléennes, numériques et de chaîne standard. Les données renvoyées par cette API s’alignent toujours sur les paramètres régionaux d’affichage de l’utilisateur. Pour récupérer des données indépendamment des paramètres régionaux, utilisez TableRow.valuesAsJson.

valuesAsJsonLocal?: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.16