DSum, 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 BDSOMME pour calculer la somme d'une série de valeurs dans un jeu d'enregistrements ( domaine ) spécifié. Utiliser la fonction BDSOMME dans un Visual Basic pour Applications (VBA) module, un macro, une expression de requête ou un contrôle calculé.

Par exemple, vous pouvez utiliser la fonction BDSOMME dans une expression de champ calculé dans une requête pour calculer le total des ventes effectuées par un employé donné sur une période donnée. Ou bien, vous pouvez utiliser la fonction BDSOMME dans un contrôle calculé pour afficher le cumul des ventes d'un produit spécifique.

Syntaxe

BDSOMME ( expr domaine [critères] )

La syntaxe de la fonction BDSOMME comporte les arguments suivants :

Argument

Description

expr

Obligatoire. Expression qui identifie le numérique dont vous voulez les valeurs de champ total. 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. Expression de chaîne utilisée pour limiter la plage de données sur laquelle porte la fonction BDSOMME . 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 BDSOMME évalue expr par rapport à l'intégralité du domaine. N'importe quel champ qui est inclus dans les critères doit également être un champ de domaine; Sinon, elle renvoie la fonction BDSOMME un Null.


Remarques

Si aucun enregistrement ne satisfait à l'argument critère ou si domaine ne contient aucun enregistrement, la fonction BDSOMME renvoie une valeur Null.

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

Vous pouvez utiliser la fonction BDSOMME pour spécifier des critères dans la ligne critères d'une requête, dans un champ calculé dans une expression de requête ou dans la ligne Mise à jour d'un requête Mise à jour.

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

Vous souhaiterez peut-être utiliser la fonction BDSOMME lorsque vous avez besoin afficher la somme d'une série de valeurs d'un champ qui n'est pas dans la source d'enregistrement de votre formulaire ou état. Par exemple, supposons que vous disposez d'un formulaire qui affiche des informations sur un produit spécifique. Vous pouvez utiliser la fonction BDSOMME pour gérer un total des ventes de ce produit dans un contrôle calculé.

Conseil

Si vous avez besoin gérer un cumul dans un contrôle dans un rapport, vous pouvez utiliser la propriété Cumul de ce contrôle, si le champ sur lequel il est basé est inclus dans la source d'enregistrement pour le rapport. Utilisez la fonction BDSOMME pour gérer un cumul dans un formulaire.

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 BDSOMME soit basée sur les valeurs modifiées, vous devez tout d'abord enregistrer les modifications en soit en cliquant sur Sauvegarder enregistrement dans le groupe enregistrements sous l'onglet accueil, déplacer le focus vers un autre enregistrement, ou en utilisant la méthode de mise à jour .

Exemples

Utiliser la fonction BDSOMME dans une expression    Vous pouvez utiliser une fonction domaine (par exemple, BDSOMME) dans la ligne Mise à jour d'une requête mise à jour. Par exemple, supposons que vous voulez effectuer le suivi des ventes en cours par produit dans une table de produits. Vous pouvez ajouter un nouveau champ appelé ventes cumulées à la table Products et exécuter une requête mise à jour pour calculer les valeurs correctes et mettre à jour les enregistrements. Pour ce faire, créez une nouvelle requête basée sur la table produits, puis sous l'onglet Création, dans le groupe Type de requête, cliquez sur mettre à jour. Ajoutez le champ cumulées à la grille de requête, puis tapez ce qui suit dans la ligne Mise à jour:

DSum("[Quantity]*[UnitPrice]", "Order Details", _
"[ProductID] = "& [ProductID])

Lorsque vous exécutez la requête, Access calcule le montant total des ventes pour chaque produit, en fonction des informations à partir d'une table Détails commande. La somme des ventes pour chaque produit est ajoutée à la table Products.

Utiliser BDSOMME dans du code VBA   

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.

L'exemple suivant totalise les valeurs du champ Freight pour les commandes expédiées au Royaume-Uni. Le domaine est une table de commandes. L'argument critère limite le jeu d'enregistrements à ceux dont la valeur du champ PaysRégionExpédition est égale à Royaume-Uni.

Dim curX As Currency
curX = DSum("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")

L'exemple suivant calcule le total à l'aide de deux critères distincts. Notez que des guillemets simples (') et les signes dièse (#) figurent dans l'expression de chaîne, de sorte que lorsque les chaînes sont concaténées, la chaîne littérale est placée entre des guillemets simples et la date est placée entre des signes dièse.

Dim curX As Currency
curX = DSum("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK' AND _
[ShippedDate] > #1-1-95#")

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.

×