DCount, 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 CpteDom pour déterminer le nombre d’enregistrements dans un jeu d’enregistrements ( domaine ). Utilisez la fonction CpteDom dans un Visual Basic pour Applications (VBA) module, un macro, une expression de requête ou un contrôle calculé.

Par exemple, vous pourriez utiliser la fonction CpteDom dans un module pour renvoyer le nombre d’enregistrements dans une table Orders qui correspondent aux commandes passées à une date spécifique.

Syntaxe

BDNB ( expr domaine [critères] )

La syntaxe de la fonction BDNB comporte les arguments suivants :

Argument

Description

expr

Obligatoire. Expression qui identifie le champ pour lequel vous souhaitez compter le nombre d’enregistrements. 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 CpteDom 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 DCount é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, la fonction CpteDom retourne un Null.


Notes

Utilisez la fonction CpteDom pour compter le nombre d’enregistrements dans un domaine lorsque vous n’avez pas besoin de connaître leur valeur spécifique. Bien que l’argument expr puisse effectuer un calcul sur un champ, la fonction CpteDom comptabilise simplement le nombre d’enregistrements. La valeur des calculs effectués par l’argument expr n’est pas disponible.

Utilisez la fonction CpteDom dans un contrôle calculé lorsque vous avez besoin spécifier des critères pour limiter la plage de données à laquelle la fonction est exécutée. Par exemple, pour afficher le nombre de commandes à livrer en Californie, définissez la propriétéforControlSoud’une zone de texte à l’expression suivante :

=DCount("[OrderID]", "Orders", "[ShipRegion] = 'CA'")

Si vous souhaitez simplement compter tous les enregistrements de domaine sans définir de restrictions, utilisez la fonction Nb .

Conseil

La fonction Count a été optimisée pour effectuer un calcul rapide des enregistrements dans les requêtes. Utilisez la fonction Count dans une expression de requête à la place de la fonction CpteDom, puis spécifiez les éventuels critères pour imposer des restrictions sur les résultats. Utilisez la fonction CpteDom compter les enregistrements d’un domaine à partir d’un module de code ou une macro, ou dans un contrôle calculé.

Vous pouvez utiliser la fonction CpteDom pour compter le nombre d’enregistrements contenant un champ particulier qui ne figure pas dans la source d’enregistrement sur lequel repose le formulaire ou l’état. Par exemple, vous pouvez afficher le nombre de commandes dans la table Orders dans un contrôle calculé dans un formulaire basé sur la table produits.

La fonction DCount ne compte pas les enregistrements qui contiennent des valeurs Null dans le champ référencé par l’argument expr sauf si expr est l’astérisque (*) comme caractère générique. Si vous utilisez un astérisque, la fonction DCount calcule le nombre total d’enregistrements, y compris ceux qui contiennent des champs Null . L’exemple suivant calcule le nombre d’enregistrements dans une table Orders.

intX = DCount("*", "Orders")

Si le domaine est une table avec une clé primaire, vous pouvez également compter le nombre total d’enregistrements par paramètre expr au champ de clé primaire, étant donné que ne peut pas contenir une valeur Null dans le champ de clé primaire.

Si expr identifie plusieurs champs, séparez les noms de champs par un opérateur de concaténation, soit une esperluette (&) ou l’opérateur d’addition (+). Si vous utilisez une esperluette pour séparer les champs, la fonction DCount renvoie le nombre d’enregistrements contenant des données dans un des champs répertoriés. Si vous utilisez l’opérateur d’addition, la fonction CpteDom renvoie uniquement le nombre d’enregistrements contenant des données dans tous les champs répertoriés. L’exemple suivant montre les effets de chaque opérateur lorsqu’il est utilisé avec un champ qui contient des données dans tous les enregistrements (destinataire) et un champ qui ne contient aucune donnée (Région livraison).

intW = DCount("[ShipName]", "Orders")
intX = DCount("[ShipRegion]", "Orders")
intY = DCount("[ShipName] + [ShipRegion]", "Orders")
intZ = DCount("[ShipName] & [ShipRegion]", "Orders")

Remarque : & Est l’opérateur préféré pour la concaténation de chaînes. Évitez d’utiliser l’opérateur d’addition pour les opérations numériques, sauf si vous voulez propager des valeurs NULL dans une expression.

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 CpteDom 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éthodeemise à 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 le nombre de commandes expédiées vers une pays/région spécifiée après une date d’expédition spécifiée. Le domaine est une table de commandes.

Public Function OrdersCount _
(ByVal strCountryRegion As String, _
ByVal dteShipDate As Date) As Integer
OrdersCount = DCount("[ShippedDate]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & _
"' AND [ShippedDate] > #" & dteShipDate & "#")
End Function

Pour appeler la fonction, utilisez la ligne suivante du code dans la fenêtre exécution :

:OrdersCount "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.

×