Fonctions d’agrégation, fonction CALC et mot clé NEW

La mise en forme des données prend en charge les fonctions suivantes. Le nom attribué au chapitre contenant la colonne à utiliser est l’alias de chapitre.

Un alias de chapitre peut être complet, composé de chaque nom de colonne de chapitre qui mène au chapitre contenant le nom de colonne, tous séparés par des points. Par exemple, si le chapitre parent, chap1, contient un chapitre enfant, chap2, qui a une colonne de quantité, amt, le nom qualifié serait chap1.chap2.amt.

Fonctions d’agrégation	Description
SUM(chapter-alias.column-name)	Calcule la somme de toutes les valeurs de la colonne spécifiée.
AVG(chapter-alias.column-name)	Calcule la moyenne de toutes les valeurs de la colonne spécifiée.
MAX(chapter-alias.column-name)	Calcule la valeur maximale dans la colonne spécifiée.
MIN(chapter-alias.column-name)	Calcule la valeur minimale dans la colonne spécifiée.
COUNT(chapter-alias[.column-name])	Compte le nombre de lignes dans l’alias spécifié. Si une colonne est spécifiée, seules les lignes pour lesquelles cette colonne n’est pas null sont incluses dans le nombre.
STDEV(chapter-alias.column-name)	Calcule l’écart type dans la colonne spécifiée.
ANY(chapter-alias.column-name)	Valeur de la colonne spécifiée. ANY a une valeur prévisible uniquement lorsque la valeur de la colonne est identique pour toutes les lignes du chapitre. Remarque Si la colonne ne contient pas la même valeur pour toutes les lignes du chapitre, la commande SHAPE retourne arbitrairement l’une des valeurs pour être la valeur de la fonction ANY.

Expression calculée	Description
CALC(expression)	Calcule une expression arbitraire, mais uniquement sur la ligne de l’objet Recordset contenant la fonction CALC. Toute expression utilisant ces fonctions Visual Basic pour Applications (VBA) est autorisée.

Mot clé NEW	Description
NEW field-type [(width | scale | precision | error [, scale | error])]	Ajoute une colonne vide du type spécifié au Recordset.

Le field-type passé avec le mot clé NEW peut être l’un des types de données suivants.

Types de données OLE DB	Équivalent(s) en type de données ADO
DBTYPE_BSTR	adBSTR
DBTYPE_BOOL	adBoolean
DBTYPE_DECIMAL	adDecimal
DBTYPE_UI1	adUnsignedTinyInt
DBTYPE_I1	adTinyInt
DBTYPE_UI2	adUnsignedSmallInt
DBTYPE_UI4	adUnsignedInt
DBTYPE_I8	adBigInt
DBTYPE_UI8	adUnsignedBigInt
DBTYPE_GUID	adGuid
DBTYPE_BYTES	adBinary, AdVarBinary, adLongVarBinary
DBTYPE_STR	adChar, adVarChar, adLongVarChar
DBTYPE_WSTR	adWChar, adVarWChar, adLongVarWChar
DBTYPE_NUMERIC	adNumeric
DBTYPE_DBDATE	adDBDate
DBTYPE_DBTIME	adDBTime
DBTYPE_DBTIMESTAMP	adDBTimeStamp
DBTYPE_VARNUMERIC	adVarNumeric
DBTYPE_FILETIME	adFileTime
DBTYPE_ERROR	adError

Lorsque le nouveau champ est de type décimal (dans OLE DB, DBTYPE_DECIMAL ou dans ADO, adDecimal), vous devez spécifier les valeurs de précision et d’échelle.

Voir aussi

Exemple de mise en forme des données
Grammaire formelle de la commande SHAPE
Généralités sur les commandes SHAPE