Excel.Interfaces.TableRowCollectionLoadOptions interface

Représente une collection de toutes les lignes du 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 de table, mais pas les données. Autrement dit, si les données sont triées ou si de nouvelles lignes sont ajoutées, une ligne de table continue à pointer vers l’index pour lequel elle a été créée.

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

Propriétés

$all

La spécification $all pour LoadOptions charge toutes les propriétés scalaires (par exemple : Range.address) mais pas les propriétés de navigation (par exemple : Range.format.fill.color).

index

Pour CHAQUE ÉLÉMENT de la collection : retourne le numéro d’index de la ligne dans la collection de lignes de la table. Avec indice zéro.

values

Pour CHAQUE ÉLÉMENT de la collection : représente les valeurs brutes de la plage spécifiée. Les données retourné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 retournée commence par un signe plus (« + »), moins (« - ») ou égal (« = »), Excel interprète cette valeur comme une formule.

valuesAsJson

Pour CHAQUE ÉLÉMENT de la collection : représentation JSON des valeurs dans les cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJson prend en charge tous les types de données qui peuvent se trouver dans une cellule. Les exemples incluent les valeurs numériques mises en forme et les images web, en plus des valeurs booléennes, numériques et de chaînes standard. Les données retournées par cette API s’alignent toujours sur les paramètres régionaux en-US. Pour récupérer des données dans les paramètres régionaux d’affichage de l’utilisateur, utilisez TableRow.valuesAsJsonLocal.

valuesAsJsonLocal

Pour CHAQUE ÉLÉMENT de la collection : représentation JSON des valeurs dans les cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJsonLocal prend en charge tous les types de données qui peuvent se trouver dans une cellule. Les exemples incluent les valeurs numériques mises en forme et les images web, en plus des valeurs booléennes, numériques et de chaînes standard. Les données retourné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 pour LoadOptions charge toutes les propriétés scalaires (par exemple : Range.address) mais pas les propriétés de navigation (par exemple : Range.format.fill.color).

$all?: boolean;

Valeur de propriété

boolean

index

Pour CHAQUE ÉLÉMENT de la collection : retourne le numéro d’index de la ligne dans la collection de lignes de la table. Avec indice zéro.

index?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

values

Pour CHAQUE ÉLÉMENT de la collection : représente les valeurs brutes de la plage spécifiée. Les données retourné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 retournée commence par un signe plus (« + »), moins (« - ») ou égal (« = »), Excel interprète cette valeur comme une formule.

values?: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

valuesAsJson

Pour CHAQUE ÉLÉMENT de la collection : représentation JSON des valeurs dans les cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJson prend en charge tous les types de données qui peuvent se trouver dans une cellule. Les exemples incluent les valeurs numériques mises en forme et les images web, en plus des valeurs booléennes, numériques et de chaînes standard. Les données retournées par cette API s’alignent toujours sur les paramètres régionaux en-US. 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

[ Ensemble d’API : ExcelApi 1.16 ]

valuesAsJsonLocal

Pour CHAQUE ÉLÉMENT de la collection : représentation JSON des valeurs dans les cellules de cette ligne de tableau. Contrairement à TableRow.values, TableRow.valuesAsJsonLocal prend en charge tous les types de données qui peuvent se trouver dans une cellule. Les exemples incluent les valeurs numériques mises en forme et les images web, en plus des valeurs booléennes, numériques et de chaînes standard. Les données retourné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

[ Ensemble d’API : ExcelApi 1.16 ]