DCOUNT |
Compteur de données |
|---|---|
| Access 2019, Access 2016, Access 2013, Access 2010, Access 2007, Access 2003, Access XP, Access 2000 | Microsoft Access |
Syntaxe
| DCount(expression,domain, [criteria]) |
Paramètres
| Nom | Description |
|---|---|
| expression | Ce paramètre permet d'indiquer expression représentant des données numériques à laquelle il faut appliquer le calcul du total. |
| domain | Ce paramètre permet d'indiquer l'ensemble d'enregistrement correspondant au domaine. |
| criteria | Ce paramètre permet d'indiquer le critère de recherche à appliquer à l'expression. |
Description
Cette fonction permet de compter un ensemble de données numérique d'un domaine ou d'un ensemble d'enregistrement.
Remarques
- La fonction compte les enregistrements d'un domaine : La fonction DCount permet de compter le nombre d'enregistrements répondant à certains critères dans une table ou une requête. Contrairement à la fonction SQL Count, elle effectue sa recherche directement dans le domaine spécifié. Cette fonction est particulièrement utile dans les formulaires et les états où aucune requête d'agrégation n'est disponible.
- Le paramètre domain identifie la source des données : Le deuxième paramètre indique le nom de la table ou de la requête dans laquelle le comptage doit être effectué. Ce domaine est indépendant de la source de données du formulaire ou de la requête courante. Grâce à cette indépendance, DCount peut accéder à pratiquement n'importe quelle table de la base de données.
- Le paramètre criteria permet de limiter le comptage : Le troisième paramètre est facultatif et sert à filtrer les enregistrements avant le comptage. Par exemple, il est possible de compter uniquement les commandes d'un client, les employés d'un service ou les produits en rupture de stock. Sans ce paramètre, tous les enregistrements du domaine sont pris en compte.
- Le comportement dépend de l'expression utilisée : Lorsque l'expression désigne un champ, DCount ne compte généralement que les enregistrements pour lesquels ce champ n'est pas Null. Si l'on souhaite compter toutes les lignes, il est courant d'utiliser "*" comme expression. Cette distinction est importante pour obtenir un résultat conforme aux attentes.
- La fonction retourne toujours un nombre entier : Le résultat de DCount est un entier représentant le nombre d'enregistrements trouvés dans le domaine. Si aucun enregistrement ne satisfait les critères spécifiés, la fonction retourne 0 plutôt qu'une erreur. Ce comportement facilite les tests et les traitements conditionnels dans les applications Access.
- Elle est très utilisée dans les formulaires et les états : DCount permet d'afficher en temps réel le nombre d'enregistrements répondant à un critère donné. Par exemple, un formulaire peut afficher le nombre de commandes d'un client ou le nombre de dossiers ouverts. Cette fonctionnalité est très appréciée pour la création de tableaux de bord et d'interfaces de suivi.
- Les critères doivent respecter la syntaxe des expressions Access : Le paramètre criteria est fourni sous forme de chaîne de caractères et doit respecter les règles de syntaxe des requêtes Access. Les valeurs textuelles doivent être entourées de guillemets simples, tandis que les dates sont généralement délimitées par le caractère #. Une erreur de syntaxe dans ce critère empêchera la fonction de retourner le résultat attendu.
- Elle appartient à la famille des fonctions de domaine : DCount fait partie du même groupe que DAvg, DSum, DLookup, DMax, DMin, DFirst et DLast. Toutes ces fonctions permettent d'effectuer des calculs ou des recherches directement dans une table ou une requête sans devoir créer une requête SQL spécifique. Elles offrent une solution rapide pour accéder à des informations ponctuelles.
- Son utilisation répétée peut affecter les performances : Chaque appel à DCount entraîne une nouvelle recherche dans le domaine spécifié. Si la fonction est exécutée de nombreuses fois sur une grande table, les performances de l'application peuvent diminuer. Dans ce cas, il est souvent préférable d'utiliser une requête SQL contenant Count, qui sera généralement plus efficace pour traiter de grands volumes de données.
- La fonction est compatible avec toutes les versions modernes de Microsoft Access : DCount est disponible depuis les premières versions de Microsoft Access et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction peuvent être migrées vers des versions plus récentes sans modification de leur logique de comptage.
Exemple
Voici un exemple de comment utiliser la fonction DCount dans Microsoft Access :
DCount("UnitPrice", "Order Details", "OrderID = 10247")
Dans cet exemple, vous renverriez le nombre d'enregistrements dans la table Order Details où l'OrderID est égal à 10247. Cela correspond à l'instruction SQL suivante :
SELECT Count([Order Details].UnitPrice) AS CountOfUnitPrice
FROM [Order Details]
WHERE ((([Order Details].OrderID)=10247));
Exemple de code VBA
La fonction DCount peut être utilisée dans le code VBA de Microsoft Access.
Par exemple :
Dim LTotal As Long
LTotal = DCount("UnitPrice", "Order Details", "OrderID = 10247")
Dans cet exemple, la variable appelée LTotal contiendrait désormais le nombre d'enregistrements dans la table Order Details où l'OrderID est 10247.
Dernière mise à jour : Mardi, le 28 juillet 2015