Table of contents
TOC
Réduire la table des matières
Développer la table des matières

Méthode Application.DSum (Access)Application.DSum Method (Access)

office 365 dev account|Dernière mise à jour: 09/04/2018
|
2 Collaborateurs

La fonction DSum calcule la somme d'un ensemble de valeurs relatives à un jeu d'enregistrements spécifié (un domaine).You can use the DSum function to calculate the sum of a set of values in a specified set of records (a domain). .

SyntaxeSyntax

expression.expression.DSum( ** Expr, ** Domain, ** Criteria** )DSum( ** Expr, ** Domain, ** Criteria** )

expression Variable qui représente un objet Application.expression A variable that represents an Application object.

ParamètresParameters

NomNameRequis/FacultatifRequired/OptionalType de donnéesData TypeDescriptionDescription
exprExprObligatoireRequiredStringStringUne expression qui identifie le champ numérique dont vous voulez totaliser les valeurs.An expression that identifies the numeric field whose values you want to total.Il peut s'agir d'une expression de type chaîne identifiant un champ dans une table ou une requête, ou peut-être une expression qui effectue un calcul sur les données dans ce champ.It can be a string expression identifying a field in a table or query, or it can be an expression that performs a calculation on data in that field .Dans expr, vous pouvez inclure le nom d’un champ dans une table, un contrôle sur un formulaire, une constante ou une fonction.In expr, you can include the name of a field in a table, a control on a form, a constant, or a function.Si expr inclut une fonction, elle peut être intégrée ou définie par l’utilisateur, mais pas une autre fonction d’agrégation de domaine ou SQL.If expr includes a function, it can be either built-in or user-defined, but not another domain aggregate or SQL aggregate function.
DomainDomainObligatoireRequiredStringStringExpression chaîne identifiant les enregistrements qui constituent le domaine. Il peut s'agir d'un nom de table ou d'un nom de requête qui ne requiert aucun paramètre.A string expression identifying the set of records that constitutes the domain. It can be a table name or a query name for a query that does not require a parameter.
CriteriaCriteriaFacultatifOptionalVariantVariantExpression de chaîne facultative servant à limiter la plage des données sur laquelle porte la fonction DSum. Par exemple, criteria est souvent équivalent à la clause WHERE d'une expression SQL sans le mot WHERE. En cas d'omission de criteria, la fonction DSum évalue expr par rapport à l'intégralité du domaine. Chaque champ compris dans criteria doit l'être aussi dans domain, sans quoi la fonction DSum renvoie la valeur Null.An optional string expression used to restrict the range of data on which the DSum function is performed. For example, criteria is often equivalent to the WHERE clause in an SQL expression, without the word WHERE. If criteria is omitted, the DSum function evaluates expr against the entire domain. Any field that is included in criteria must also be a field in domain; otherwise, the DSum function returns a Null.

Valeur renvoyéeReturn Value

VariantVariant

RemarquesRemarks

Par exemple, la fonction DSum peut être utilisée dans une expression de champ calculé d'une requête pour calculer les ventes totales réalisées par un employé pendant une certaine période. Vous pouvez utiliser la fonction DSum dans un contrôle calculé pour afficher le cumul des ventes d'un produit particulier.For example, you could use the DSum function in a calculated field expression in a query to calculate the total sales made by a particular employee over a period of time. Or you could use the DSum function in a calculated control to display a running sum of sales for a particular product.

Si aucun enregistrement ne satisfait à l'argument criteria, ou si le domaine ne contient aucun enregistrement, la fonction DSum renvoie la valeur Null.If no record satisfies the criteria argument or if domain contains no records, the DSum function returns a Null.

Que vous utilisiez la fonction DSum dans une macro, un module, une expression de requête ou un contrôle calculé, construisez l'argument criteria avec soin pour qu'il soit évalué correctement.Whether you use the DSum function in a macro, module, query expression, or calculated control, you must construct the criteria argument carefully to ensure that it will be evaluated correctly.

Vous pouvez utiliser la fonction DSum pour spécifier des critères dans la ligne Critères d'une requête, dans un champ calculé d'une expression de requête, ou dans la ligne Mise à jour d'une requête de mise à jour.You can use the DSum function to specify criteria in the Criteria row of a query, in a calculated field in a query expression, or in the Update To row of an update query.

Remarque Vous pouvez utiliser la fonction DSum ou Sum dans une expression de champ calculé d'une requête Opérations. Avec la fonction DSum, les valeurs sont calculées avant le regroupement des données. Avec la fonction Sum, les données sont regroupées avant que les valeurs incluses dans l'expression de champ ne soient calculées.Note You can use either the DSum or Sum function in a calculated field expression in a totals query. If you use the DSum function, values are calculated before data is grouped. If you use the Sum function, the data is grouped before values in the field expression are evaluated.

Il peut être judicieux d'utiliser la fonction DSum pour afficher la somme d'un ensemble de valeurs relatives à un champ qui n'appartient pas à la source d'enregistrements sur laquelle votre formulaire ou votre état est fondé. Par exemple, dans un formulaire affichant les informations concernant un produit particulier, vous pouvez gérer le cumul des ventes de ce produit dans un contrôle calculé à l'aide de la fonction DSum.You may want to use the DSum function when you need to display the sum of a set of values from a field that is not in the record source for your form or report. For example, suppose you have a form that displays information about a particular product. You could use the DSum function to maintain a running total of sales of that product in a calculated control.

Pour gérer un cumul dans un contrôle d'état, utilisez la propriété RunningSum de ce contrôle, si le champ sur lequel il est basé fait partie de la source d'enregistrements de l'état. Utilisez la fonction DSum pour gérer un cumul dans un formulaire.If you need to maintain a running total in a control on a report, you can use the RunningSum property of that control if the field on which it is based is included in the record source for the report. Use the DSum function to maintain a running sum on a form.

ExempleExample

L'exemple suivant totalise les valeurs du champ Port pour les commandes livrées au Royaume-Uni. Le domaine est une table Commandes. L'argument critère limite le jeu d'enregistrements à ceux pour lesquels le pays de livraison est le Royaume-Uni.The following example totals the values from the Freight field for orders shipped to the United Kingdom. The domain is an Orders table. The criteria argument restricts the resulting set of records to those for which ShipCountry equals UK.

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

L'exemple suivant calcule une somme à l'aide de deux critères séparés. Remarquez que des guillemets simples (') et des signes numériques (#) sont inclus dans l'expression chaîne pour que la chaîne UK (Royaume-Uni) soit comprise entre guillemets simples et les dates soient comprises entre des signes numériques lors de la concaténation des chaînes.The next example calculates a total by using two separate criteria. Note that single quotation marks (') and number signs (#) are included in the string expression, so that when the strings are concatenated, the string literal will be enclosed in single quotation marks, and the date will be enclosed in number signs.

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

Les exemples suivants montrent comment utiliser différents types de critères avec la fonction DSum.The following examples show how to use various types of criteria with the DSum function.

Exemple de code fourni par :icône de membre de la communauté la communauté UtterAccessSample code provided by:Community Member Icon TheUtterAccess community

    ' ***************************
    ' Typical Use
    ' Numerical values. Replace "number" with the number to use.
    variable = DSum("[FieldName]", "TableName", "[Criteria] = number")

    ' Strings.
    ' Numerical values. Replace "string" with the string to use.
    variable = DSum("[FieldName]", "TableName", "[Criteria]= 'string'")

    ' Dates. Replace "date" with the string to use.
    variable = DSum("[FieldName]", "TableName", "[Criteria]= #date#")
    ' ***************************

    ' ***************************
    ' Referring to a control on a form
    ' Numerical values
    variable = DSum("[FieldName]", "TableName", "[Criteria] = " &; Forms!FormName!ControlName)

    ' Strings
    variable = DSum("[FieldName]", "TableName", "[Criteria] = '" &; Forms!FormName!ControlName &; "'")

    ' Dates
    variable = DSum("[FieldName]", "TableName", "[Criteria] = #" &; Forms!FormName!ControlName &; "#")
    ' ***************************

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DSum("[FieldName]", "TableName", "[Criteria1] = " &; Forms![FormName]![Control1] _
             &; " AND [Criteria2] = '" &; Forms![FormName]![Control2] &; "'" _
            &; " AND [Criteria3] =#" &; Forms![FormName]![Control3] &; "#")

    ' Use two fields from a single record.
    variable = DSum("[LastName] &; ', ' &; [FirstName]", "tblPeople", "[PrimaryKey] = 7")

    ' Expressions
    variable = DSum("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")

    ' Control Structures
    variable = DSum("IIf([LastName] Like 'Smith', 'True', 'False')", "tableName", "[PrimaryKey] = 7")
    ' ***************************

À propos des contributeursAbout the Contributors

UtterAccess est le premier forum d'aide et wiki de Microsoft Access. Cliquez ici pour le rejoindre.UtterAccess is the premier Microsoft Access wiki and help forum. Click here to join.

Voir aussiSee also

ConceptsConcepts

Application, objetApplication Object

© 2018 Microsoft