DAvg, fonction

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

Vous pouvez utiliser la fonction DAvg pour calculer la moyenne d’une série de valeurs dans un jeu d’enregistrements ( domaine ) spécifié. Utilisez la fonction DAvg dans un module Visual Basic pour Applications (VBA), un macro, une expression de requête ou un contrôle calculé.

Par exemple, utilisez la fonction DAvg dans la ligne Critères d’une requête sélection relative au coût freight pour limiter les résultats aux enregistrements pour l’endroit où les frais de transport dépasse la moyenne. Ou vous pouvez également utiliser une expression incluant la fonction DAvg dans un contrôle calculé et afficher la valeur moyenne des commandes précédentes en regard de la valeur d’un nouvel ordre.

Syntaxe

DAvg ( expr domaine [critères] )

La syntaxe de la fonction DAvg comporte les arguments suivants :

Argument

Description

expr

Obligatoire. Expression qui identifie le champ contenant les données numériques que vous voulez calculer la moyenne. Il peut être un expression de chaîne identifiant un champ dans une table ou requête, ou elle peut être 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 sur 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 sur un autre domaine agrégation ou fonction d’agrégation SQL.

domaine

Obligatoire. Une expression de chaîne identifiant le jeu d’enregistrements qui constituent le domaine. Il peut être un nom de table ou un nom de requête pour une requête qui ne nécessite pas un paramètre.

critères

Facultatif. Une expression de chaîne utilisée pour limiter la plage de données à laquelle la fonction DAvg est exécutée. Par exemple, critères est souvent équivalent à la clause WHERE dans une expression SQL, sans le mot où. Si l’argument critères est omis, la fonction DAvg évalue expr par rapport à l’intégralité du domaine. N’importe quel champ qui est incluse dans criteriun doit également être un champ de domaine; Sinon, la fonction DAvg renvoie un Null.


Notes

Les enregistrements contenant des valeurs Null ne sont pas inclus dans le calcul de la moyenne.

Si vous utilisez la fonction DAvg dans une macro ou le module, dans une expression de requête ou dans un contrôle calculé, vous devez construire l’argument critère avec soin pour vous assurer qu’il sera évaluée correctement.

Vous pouvez utiliser la fonction DAvg pour spécifier des critères dans la ligne Critères d’une requête. Par exemple, supposons que vous voulez afficher une liste de tous les produits classés en quantités supérieures à la moyenne. Vous créez une requête sur les commandes, les détails de la commande et les tables Products dans l’et inclure le champ nom du produit et le champ Quantité, avec l’expression suivante dans la ligne critères au-dessous du champ Quantity :

>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’un requête Mise à jour.

Remarque : Vous pouvez utiliser la fonction les DAvg ou Avg dans une expression de champ calculé dans une requête Opérations. Si vous utilisez la fonction DAvg , moyenne des valeurs sont calculées avant le regroupement des données. Si vous utilisez la fonction Avg , les données sont regroupées avant de la moyenne des valeurs dans l’expression de champ.

Utilisez la fonction DAvg dans un contrôle calculé lorsque vous avez besoin spécifier des critères pour limiter la plage de données sur laquelle porte la fonction DAvg . Par exemple, pour afficher le coût moyen du port pour les envois envoyé en Californie, définissez la propriété SourceContrôle d’une zone de texte à l’expression suivante :

=DAvg("[Freight]", "Orders", "[ShipRegion] = 'CA'")

Si vous voulez simplement calculer la moyenne de tous les enregistrements de domaine, utilisez la fonction Avg .

Vous pouvez utiliser la fonction DAvg dans un module de macro ou dans un contrôle calculé sur un formulaire si un champ que vous devez afficher ne figure pas dans la source d’enregistrement sur lequel repose votre formulaire. Par exemple, supposons que vous avez un formulaire basé sur la table Orders, et que vous voulez inclure le champ Quantity de la table Détails commande afin d’afficher le nombre moyen d’éléments classés par un client donné. Vous pouvez utiliser la fonction DAvg 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 souhaiterez peut-être placer le contrôle sur l’en-tête de formulaire ou le pied de page afin que la valeur de ce contrôle n’est pas recalculée chaque fois que vous passez à un nouvel enregistrement.

  • Si le type de données du champ sur lequel expr 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 DAvg pour calculer la moyenne des valeurs d’un champ dans une table étrangère, il peut être plus efficace de créer une requête qui contient tous les champs que vous avez besoin, puis de basez votre formulaire ou l’état sur cette requête.

Remarque : Les modifications non enregistrées dans des enregistrements de 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 Sauvegarder enregistrement sous enregistrements sous l’onglet données , déplacer le focus vers un autre enregistrement, ou en utilisant la méthode de mise à jour .

Exemple

Remarque : Exemples suivants illustrent l’utilisation de cette fonction dans une Visual Basic pour le module d’Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence du développeur dans la liste déroulante en regard de recherche et entrez un ou plusieurs termes dans la zone de recherche.

La fonction suivante renvoie la moyenne des frais pour les commandes expédiées ou après une date donnée. Le domaine est une table de commandes. L’argument critère limite le jeu d’enregistrements basés sur la date d’expédition et de pays/région donnée. Notez que le mot clé et est inclus dans la chaîne pour séparer les différents champs dans l’argument critère . Tous les enregistrements inclus dans le calcul de la fonction DAvg devront ces 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 suivante du code dans la fenêtre exécution :

:AvgFreightCost "UK", #1/1/96#

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×