Vous pouvez utiliser les fonctions DVar et DVarP pour estimer la variance sur un ensemble de valeurs dans un jeu d’enregistrements spécifié (un domaine ). Utilisez les fonctions DVar et DVarP dans un module Visual Basic pour Applications (VBA), un macro, une expression de requête ou un contrôle calculé sur un formulaire ou un état.
Utilisez la fonction DVarP pour évaluer la variance dans une population et la fonction DVar pour évaluer la variance dans un échantillon de population.
Par exemple, vous pouvez utiliser la fonction DVar pour calculer la variance sur un ensemble de scores aux tests des étudiants.
Syntaxe
DVar ( expr , domain [, criteria] )
DVarP ( expr , domain [, criteria] )
Les fonctions DVar et DVarP ont les arguments suivants :
|
Argument |
Description |
|
expr |
Obligatoire. Expression qui identifie le champ numérique sur lequel vous souhaitez trouver la variance. Il peut s’agir d’un expression de chaîne identifiant un champ à partir d’une table ou d’une requête, ou d’une expression qui effectue un calcul sur les données de ce champ. Par exemple, vous pouvez inclure le champ de nom 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 une autre fonction d’agrégation de domaine ou SQL. Tout champ inclus dans expr doit être un champ numérique. |
|
domaine |
Obligatoire. Expression de chaîne identifiant le jeu d’enregistrements qui constitue le domaine. Il peut s’agir d’un nom de table ou d’un nom de requête pour une requête qui ne nécessite pas de paramètre. |
|
critères |
Facultatif. Expression de chaîne utilisée pour restreindre la plage de données sur laquelle la fonction DVar ou DVarP est exécutée. Par exemple, les critères sont souvent équivalents à la clause WHERE dans une expression SQL, sans le mot WHERE. Si les critères sont omis , les fonctions DVar et DVarPévaluent expr par rapport à l’ensemble du domaine. Tout champ inclus dans les critères doit également être un champ dans le domaine ; sinon, les fonctions DVar et DVarP retournent une valeur Null. |
Remarques
Si le domaine fait référence à moins de deux enregistrements ou si moins de deux enregistrements répondent à criteria, les fonctions DVar et DVarP renvoient une valeur Null, indiquant qu’une variance ne peut pas être calculée.
Que vous utilisiez la fonction DVar ou DVarP 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 sera évalué correctement.
Vous pouvez utiliser les fonctions DVar et DVarP pour spécifier des critères dans la ligne Critères d’une requête select, dans une expression de champ calculé dans une requête ou dans la ligne Mettre à jour vers d’une requête de mise à jour.
Remarque : Vous pouvez utiliser les fonctions DVar et DVarP ou les fonctions Var et VarP dans une expression de champ calculé dans un requête Opérations. Si vous utilisez la fonction DVar ou DVarP , les valeurs sont calculées avant le regroupement des données. Si vous utilisez la fonction Var ou VarP , les données sont regroupées avant que les valeurs de l’expression de champ soient évaluées.
Utilisez les fonctions DVar et DVarP dans un contrôle calculé lorsque vous devez spécifier des critères pour restreindre la plage de données sur laquelle la fonction est exécutée. Par exemple, pour afficher une variance pour les commandes à expédier en Californie, définissez la propriété ControlSource d’une zone de texte sur l’expression suivante :
=DVar("[Freight]", "Orders", "[ShipRegion] = 'CA'")
Si vous souhaitez simplement trouver l’écart type sur tous les enregistrements du domaine, utilisez la fonction Var ou VarP .
Remarque : Les modifications non enregistrées apportées aux enregistrements dans le domaine ne sont pas incluses lorsque vous utilisez ces fonctions. Si vous souhaitez que la fonction DVar ou DVarP soit basée sur les valeurs modifiées, vous devez d’abord enregistrer les modifications en cliquant sur Enregistrer l’enregistrement sous Enregistrements sous l’onglet Données , en déplaçant le focus vers un autre enregistrement ou en utilisant la méthode Update .
Exemple de requête
|
Expression |
Résultats |
|
SELECT DVar(« unitprice »,"productSales »,"unitprice>140 ») AS DVar_Value, DVarP(« unitprice »,"productSales »,"unitprice<140 ») AS DVarP_Value FROM productSales GROUP BY DVar(« unitprice »,"productSales »,"unitprice>140 »), DVarP(« unitprice »,"productSales »,"unitprice<140 ») ; |
Calcule la variance de « UnitPrice » à partir de la table « ProductSales » où « unitprice » est supérieur à 140 et affiche le résultat dans DVar_Value. Calcule également la variance de « UnitPrice » (en considérant les données données comme la population entière) où « unitprice » est inférieur à 140 et affiche les résultats dans DVarP_Value. |
Exemples VBA
Remarque : Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour 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 Rechercher et entrez un ou plusieurs termes dans la zone de recherche.
L’exemple suivant retourne des estimations de la variance pour une population et un échantillon de population pour les commandes expédiées au Royaume-Uni. Le domaine est une table Orders. L’argument critère limite le jeu d’enregistrements résultant à ceux pour lesquels ShipCountryRegion est égal à UK.
Dim dblX As Double
Dim dblY As Double
' Sample estimate.
dblX = DVar("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")
' Population estimate.
dblY = DVarP("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")
L’exemple suivant retourne des estimations à l’aide d’une variable, strCountryRegion, dans l’argument critère . Notez que les guillemets simples (') sont inclus dans l’expression de chaîne, de sorte que lorsque les chaînes sont concaténées, le littéral de chaîne UK est placé entre guillemets simples.
Dim strCountryRegion As String
Dim dblX As Double
strCountryRegion = "UK"
dblX = DVar("[Freight]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & "'")
