Funkce DAvg

Funkci DAvg můžete použít k výpočtu průměru sady hodnot v zadané sadě záznamů (doméně). Funkci DAvg použijte v modulu Jazyka VBA (jazyk Visual Basic for Application), v makrech, ve výrazu dotazu nebo v počítaném ovládacím prvku.

Funkci DAvg můžete například použít v řádku kritérií výběrového dotazu na přepravní náklady a omezit s ní výsledky na ty záznamy, kde přepravní náklady převyšují průměr. Nebo můžete použít výraz zahrnující funkci DAvg v počítaném ovládacím prvku a zobrazit průměrnou hodnotu předchozích objednávek vedle hodnoty nové objednávky.

Syntaxe

DAvg(výraz, doména [, kritéria] )

Syntaxe funkce DAvg obsahuje následující argumenty:

Argument	Popis
výraz	Povinný argument. Výraz, který identifikuje pole obsahující číselná data, která chcete zprůměrovat. Může to být řetězcový výraz identifikující pole v tabulce nebo dotazu nebo výraz, který provádí výpočet dat v daném poli. V výrazu můžete zahrnout název pole v tabulce, ovládací prvek ve formuláři, konstantu nebo funkci. Pokud výraz obsahuje funkci, může být buď integrovaná, nebo uživatelem definovaná, ale ne jiná doménová agregace nebo agregační funkce SQL.
doména	Povinný argument. Řetězcový výraz identifikuje sadu záznamů tvořících doménu. Může jít o název tabulky nebo název dotazu, který nevyžaduje parametr.
kritéria	Nepovinný argument. Řetězcový výraz, který se používá k omezení rozsahu dat, na kterém se provádí funkce DAvg . Například kritéria jsou často ekvivalentní klauzuli WHERE ve výrazu SQL bez slova WHERE. Pokud jsou kritéria vynechána, funkce DAvg vyhodnotí výraz pro celou doménu. Každé pole, které je součástí kritérií , musí být také polem v doméně; V opačném případě funkce DAvg vrátí hodnotu Null.

    

Poznámky

Záznamy, které obsahují hodnoty Null, nejsou zahrnuté do výpočtu průměru.

Ať už funkci DAvg používáte v makrech nebo modulu, ve výrazu dotazu nebo v počítaném ovládacím prvku, musíte argument kritéria sestavit pečlivě, abyste zajistili, že bude vyhodnocen správně.

Funkci DAvg můžete použít k zadání kritérií v řádku Kritéria v dotazu. Předpokládejme například, že chcete zobrazit seznam všech produktů objednaných v množství nad průměrným množstvím. Mohli byste vytvořit dotaz na tabulky Objednávky, Podrobnosti objednávky a Produkty a zahrnout pole Název produktu a pole Množství s následujícím výrazem v řádku Kritéria pod polem Množství:

>DAvg("[Quantity]", "Orders")

Funkci DAvg můžete použít také v rámci výrazu počítaného pole v dotazu nebo v řádku Aktualizovat do aktualizačního dotazu.

Funkci DAvg použijte v počítaném ovládacím prvku, když potřebujete zadat kritéria k omezení oblasti dat, s kterou bude funkce DAvg provedena. Pokud například chcete zobrazit průměrné přepravní náklady na poslání zboží do Kalifornie, nastavte u vlastnosti .Zdrojovládacíhoprvku textového pole následující výraz:

=DAvg("[Freight]", "Orders", "[ShipRegion] = 'CA'")

Pokud chcete jednoduše zprůměrovat všechny záznamy v doméně, použijte funkci Avg .

Funkci DAvg je možné použít v modulu nebo makru nebo v počítaném ovládacím prvku ve formuláři, pokud se pole, které chcete zobrazit, nenachází ve zdroji záznamů, na kterém je daný formulář založený. Předpokládejme například, že máte formulář založený na tabulce Objednávky a chcete zahrnout pole Množství z tabulky Podrobnosti objednávky, aby se zobrazoval průměrný počet položek objednaných určitým zákazníkem. K provedení tohoto výpočtu a zobrazení dat ve formuláři můžete použít funkci DAvg.

Tipy

• Pokud použijete funkci DAvg v počítaném ovládacím prvku, můžete umístit ovládací prvek do záhlaví nebo zápatí formuláře, aby se hodnota tohoto ovládacího prvku nepřepočítávala pokaždé, když přejdete na nový záznam.
• Pokud je datovým typem pole, ze kterého je výraz odvozen, číslo, vrátí funkce DAvg datový typ Double. Pokud v počítaném ovládacím prvku používáte funkci DAvg , zahrňte do výrazu funkci převodu datového typu, aby se zlepšil výkon.
• I když můžete použít funkci DAvg k určení průměru hodnot v poli v cizí tabulce, může být efektivnější vytvořit dotaz, který obsahuje všechna pole, která potřebujete, a pak založit formulář nebo sestavu na daném dotazu.

Příklad

Následující funkce vrátí průměr přepravních nákladů pro objednávky poslané určený den nebo později. Doménou je tabulka Objednávky. Argument kritéria omezuje výslednou sadu záznamů na základě dané země/oblasti a data expedice. Všimněte si, že klíčové slovo AND je součástí řetězce pro oddělení více polí v argumentu kritéria . Všechny záznamy, které jsou součástí výpočtu funkce DAvg, budou mít obě tato kritéria.

Public Function AvgFreightCost _
    (ByVal strCountryRegion As String, _
     ByVal dteShipDate As Date) As Double
    AvgFreightCost = DAvg("[Freight]", "Orders", _
        "[ShipCountryRegion] = '" & strCountryRegion & _
        "'AND [ShippedDate] >= #" & dteShipDate & "#")
End Function

Pokud chcete funkci volat, použijte následující řádek kódu v okně Hodnoty:

:AvgFreightCost "UK", #1/1/96#