Vous pouvez utiliser la fonction moyenne pour calculer la moyenne d’un ensemble de valeurs dans un jeu d’enregistrements spécifié (une domaine ). Utilisez la fonctionVg dans un module Visual Basic pour Applications (VBA), dans une macro, dans une expression de requête ou dans une contrôle calculé.
Par exemple, vous pouvez utiliser la fonction moyenne dans la ligne Critères d’une requête Sélection sur les coûts de transport afin de limiter les résultats aux enregistrements dont le coût de transport dépasse la moyenne. Vous pouvez également utiliser une expression incluant la fonction MoyenneAvg dans un contrôle calculé et afficher la valeur moyenne des commandes précédentes à côté de la valeur d’une nouvelle commande.
Syntaxe
DAvg ( expr, domain [ ,criteria] )
La syntaxe de la fonction Duvg a les arguments suivantes :
|
Argument |
Description |
|
expr |
Obligatoire. Expression qui identifie le champ contenant les données numériques dont vous voulez déterminer la moyenne. Il peut s' expression de chaîne d’identifier un champ dans une table ou une requête, ou il peut s’agit d’une expression qui effectue un calcul sur les données de ce champ. Dans expr,vous pouvez inclure le nom d’un champ dans une table, un contrôle dans un formulaire, une constante ou une fonction. Si expr inclut une fonction, elle peut être intégrée ou définie par l’utilisateur, mais pas une autre agrégation de domaine ou SQL fonction d’agrégation. |
|
domaine |
Obligatoire. Expression de chaîne identifiant l’ensemble d’enregistrements qui constitue le domaine. Il peut s’agit d’un nom de table ou de requête pour une requête qui ne nécessite pas de paramètre. |
|
critère |
Facultatif. Expression de chaîne utilisée pour limiter la plage de données sur laquelle la fonction Moyenne D est exécutée. Par exemple, les critères sont souvent équivalents à la clause WHERE dans une expression SQL, sans le mot WHERE. Si critère est omis, la fonction DAvg évalue expr par rapport au domaine entier. Tout champ inclus dans le critérisquedoit également être un champ de domaine; sinon, la fonctionVg renvoie la valeur Null. |
Remarques
Les enregistrements contenant des valeurs Null ne sont pas inclus dans le calcul de la moyenne.
Que vous utilisons la fonction DAvg dans une macro ou un module, dans une expression de requête ou dans un contrôle calculé, vous devez créer l’argument critères avec soin pour vous assurer qu’il sera évalué correctement.
Vous pouvez utiliser la fonctionVg pour spécifier des critères dans la ligne Critères d’une requête. Par exemple, supposons que vous vouliez afficher la liste de tous les produits commandés dans des quantités supérieures à la quantité de commandes moyenne. Vous pouvez créer une requête dans les tables Commandes, Détails de la commande et Produits, et inclure les champs Nom du produit et Quantité, avec l’expression suivante dans la ligne Critères sous le champ Quantité :
>DAvg("[Quantity]", "Orders")
Vous pouvez également utiliser la fonction DAvg dans une expression de champ calculé dans une requête ou dans la ligne Mise à jour d’une requête Mise à jour.
Remarque : Vous pouvez utiliser la fonctionVg ou Avg dans une expression de champ calculé dans une requête Opérations. Si vous utilisez la fonction MoyenneDA, les valeurs sont moyennes avant le regroupement des données. Si vous utilisez la fonction Moyenne, les données sont regroupées avant la moyenne des valeurs dans l’expression de champ.
Utilisez la fonction MoyenneDa dans un contrôle calculé lorsque vous avez besoin de spécifier des critères pour limiter la plage de données sur laquelle la fonction DAvg est exécutée. Par exemple, pour afficher le coût moyen des transports d’expéditions envoyées en Californie, définissez la propriété Source Contrôle d’une zone de texte sur l’expression suivante :
=DAvg("[Freight]", "Orders", "[ShipRegion] = 'CA'")
Si vous voulez simplement moyenner tous les enregistrements dansun domaine, utilisez la fonction Moyenne.
Vous pouvez utiliser la fonctionVg dans un module ou une macro, ou dans un contrôle calculé sur un formulaire si un champ que vous devez afficher ne se trouve pas dans la source d’enregistrement sur laquelle repose votre formulaire. Par exemple, supposons que vous avez un formulaire basé sur la table Commandes et que vous voulez inclure le champ Quantité de la table Détails commande afin d’afficher le nombre moyen d’articles commandés par un client particulier. Vous pouvez utiliser la fonctionVg pour effectuer ce calcul et afficher les données sur votre formulaire.
Conseils
-
Si vous utilisez la fonction DAvg dans un contrôle calculé, vous souhaitez peut-être placer le contrôle dans l’en-tête ou le pied de formulaire afin que la valeur de ce contrôle ne soit pas recalculée chaque fois que vous déplacez vers un nouvel enregistrement.
-
Si le type de données du champ à partir duquel expr est dérivé est un nombre, la fonction DAvg renvoie un type de données Double. Si vous utilisez la fonction DAvg dans un contrôle calculé, incluez une fonction de conversion de type de données dans l’expression pour améliorer les performances.
-
Bien que vous pouvez utiliser la fonction moyenne pour déterminer la moyenne des valeurs d’un champ dans une table étrangère, il peut être plus efficace de créer une requête contenant tous les champs dont vous avez besoin, puis de baser votre formulaire ou état sur cette requête.
Remarque : Les modifications apportées sans enregistrement à des enregistrements dans un domaine ne sont pas incluses lorsque vous utilisez cette fonction. Si vous souhaitez que la fonction DAvg soit basée sur les valeurs modifiées, vous devez tout d’abord enregistrer les modifications en cliquant sur Enregistrer l’enregistrement sous Enregistrements sous l’onglet Données, en déplaçant le focus vers un autre enregistrement ou en utilisant la méthode de mise à jour.
Exemple
Remarque : Les exemples qui suivent illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’travail avec VBA, sélectionnez Référence du développeur dans la liste de listes en regard de Rechercher, puis entrez un ou plusieurs termes dans la zone de recherche.
La fonction suivante renvoie le coût de transport moyen des commandes expédiées à ou après une date donnée. Le domaine est une table Commandes. L’argument critères restreint le jeu d’enregistrements résultant en fonction du pays/de la région et de la date d’expédition donnés. Notez que le mot clé ET est inclus dans la chaîne pour séparer les champs dans l’argument critères. Tous les enregistrements inclus dans le calcul de la fonction DAvg auront les deux critères.
Public Function AvgFreightCost _
(ByVal strCountryRegion As String, _
ByVal dteShipDate As Date) As Double
AvgFreightCost = DAvg("[Freight]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & _
"'AND [ShippedDate] >= #" & dteShipDate & "#")
End Function
Pour appeler la fonction, utilisez la ligne de code suivante dans la fenêtre Immédiate :
:AvgFreightCost "UK", #1/1/96#
