Sie können die DomMittelwert-Funktion verwenden, um den Mittelwert einer Gruppe von Werten in einer bestimmten Gruppe von Datensätzen (einer Domäne) zu berechnen. Verwenden Sie die DomMittelwert-Funktion in einem Visual Basic for Applications (VBA)-Modul, in einem Makro, in einem Abfrageausdruck oder in einem berechneten Steuerelement.
Sie können die DomMittelwert-Funktion beispielsweise in der Zeile "Kriterien" einer Auswahlabfrage für Frachtkosten verwenden, um die Ergebnisse auf Datensätze zu beschränken, in denen die Frachtkosten den Mittelwert übersteigen. Sie können auch einen Ausdruck, der die DomMittelwert-Funktion enthält, in einem berechneten Steuerelement verwenden, um den Durchschnittswert vorheriger Bestellungen neben dem Wert einer neuen Bestellung anzuzeigen.
Syntax
DAvg(expr, domain [, criteria] )
Die Syntax der DomMittelwert-Funktion weist die folgenden Argumente auf:
| Argument | Beschreibung |
|---|---|
| Ausdruck | Erforderlich. Ein Ausdruck, der das Feld mit den numerischen Daten identifiziert, für die ein Mittelwert erstellt werden soll. Hierbei kann es sich um einen Zeichenfolgenausdruck handeln, der ein Feld in einer Tabelle oder Abfrage identifiziert, oder um einen Ausdruck, der eine Berechnung der Daten in diesem Feld durchführt. In Ausdruck können Sie den Namen eines Felds in einer Tabelle, eines Steuerelements in einem Formular, einer Konstante oder einer Funktion einfügen. Wenn Ausdr eine Funktion enthält, kann sie entweder integriert oder benutzerdefiniert sein, aber keine andere Domänenaggregat- oder SQL-Aggregatfunktion. |
| Domäne | Erforderlich. Ein Zeichenfolgenausdruck, der die Gruppe von Datensätzen angibt, die die Domäne bilden. Es kann sich um einen Tabellennamen oder um einen Abfragenamen für eine Abfrage handeln, die keinen Parameter erfordert. |
| Kriterien | Optional. Ein Zeichenfolgenausdruck, der zum Einschränken des Datenbereichs verwendet wird, für den die DAvg-Funktion ausgeführt wird. Kriterien entsprechen z. B. häufig der WHERE-Klausel in einem SQL-Ausdruck ohne das Wort WHERE. Wenn Kriterien weggelassen werden, wertet die DomMittelwert-Funktiondie Auswertung für die gesamte Domäne aus. Jedes Feld, das in den Kriterien enthalten ist, muss auch ein Feld in der Domäne sein. Andernfalls gibt die DAvg-Funktion einen Nullwert zurück. |
Anmerkungen
Datensätze, die NULL-Werte enthalten, werden nicht in die Berechnung des Mittelwerts aufgenommen.
Unabhängig davon, ob Sie die DomMittelwert-Funktion in einem Makro oder Modul, in einem Abfrageausdruck oder in einem berechneten Steuerelement verwenden, müssen Sie das Argument Kriterien sorgfältig auswählen, um sicherzustellen, dass es richtig ausgewertet wird.
Sie können die DomMittelwert-Funktion verwenden, um Kriterien in der Zeile "Kriterien" einer Abfrage anzugeben. Nehmen Sie beispielsweise an, dass Sie eine Liste aller Artikel anzeigen möchten, deren Bestellmenge die durchschnittliche Bestellmenge übersteigt. Sie können eine Abfrage für die Tabellen "Bestellungen", "Bestelldetails" und "Produkte" erstellen, die jeweils die Felder "Produktname" und "Menge" enthalten, indem Sie den folgenden Ausdruck in die Zeile "Kriterien" unterhalb des Felds "Menge" einfügen:
>DAvg("[Quantity]", "Orders")
Sie können die DomMittelwert-Funktion auch innerhalb eines berechneten Feldausdrucks in einer Abfrage oder in der Zeile "Aktualisieren bis" einer Aktualisierungsabfrage verwenden.
Hinweis
Sie können entweder die DomMittelwert-Funktion oder die Mittelwert-Funktion in einem berechneten Feldausdruck in einer Gesamtsummenabfrage verwenden. Wenn Sie die DomMittelwert-Funktion verwenden, wird für die Werte vor dem Gruppieren der Daten ein Mittelwert berechnet. Beim Verwenden der Mittelwert-Funktion werden die Daten zunächst gruppiert, bevor für die Werte im Feldausdruck ein Mittelwert berechnet wird.
Verwenden Sie die DomMittelwert-Funktion in einem berechneten Steuerelement, wenn Sie "Kriterien" zum Beschränken des Datenbereichs angeben möchten, für den die DomMittelwert-Funktion ausgeführt wird. Legen Sie für die Steuerelementinhalt-Eigenschaft eines Textfelds beispielsweise den folgenden Ausdruck fest, um die durchschnittlichen Frachtkosten für Lieferungen nach Kalifornien anzuzeigen:
=DAvg("[Freight]", "Orders", "[ShipRegion] = 'CA'")
Wenn Sie einfach den Mittelwert für alle Datensätze in der Domäne berechnen möchten, verwenden Sie die Mittelwert-Funktion.
Sie können die DomMittelwert-Funktion in einem Modul oder Makro oder in einem berechneten Steuerelement in einem Formular verwenden, wenn sich ein anzuzeigendes Feld nicht in der Datensatzquelle befindet, auf der das Formular basiert. Angenommen, ein Formular basiert auf der Tabelle "Bestellungen" und Sie möchten das Feld "Menge" aus der Tabelle "Bestelldetails" einfügen, damit die durchschnittliche Anzahl von Artikeln angezeigt wird, die von einem bestimmten Kunden bestellt wurde. Sie können die DomMittelwert-Funktion verwenden, um diese Berechnung durchzuführen und die Daten im Formular anzuzeigen.
Tipps
- Wenn Sie die DomMittelwert-Funktion in einem berechneten Steuerelement verwenden, empfiehlt es sich, das Steuerelement im Formularkopf oder Formularfuß zu platzieren, damit der Wert für dieses Steuerelement nicht jedes Mal neu berechnet wird, wenn Sie zu einem neuen Datensatz wechseln.
- Wenn der Datentyp des Felds, von dem Ausdr abgeleitet wird, eine Zahl ist, gibt die DomMittelwert-Funktion den Datentyp "Double" zurück. Fügen Sie zur Leistungsverbesserung eine Konvertierungsfunktion für den Datentyp in den Ausdruck ein, wenn Sie die DomMittelwert-Funktion in einem berechneten Steuerelement verwenden.
- Sie können mithilfe der DomMittelwert-Funktion zwar den Mittelwert der Werte in einem Feld in einer Fremdtabelle ermitteln. Es kann jedoch effizienter sein, eine Abfrage zu erstellen, die alle benötigten Felder enthält, und dann das Formular bzw. den Bericht auf dieser Abfrage zu basieren.
Hinweis
Nicht gespeicherte Änderungen an Datensätzen in der Domäne werden bei Verwendung dieser Funktion nicht eingeschlossen. Wenn die DomMittelwert-Funktion auf den geänderten Werten basieren soll, müssen Sie die Änderungen zunächst speichern, indem Sie auf der Registerkarte Daten unter Datensätze auf Datensatz speichern klicken, damit der Fokus zu einem anderen Datensatz wechselt, oder indem Sie die Methode Aktualisieren verwenden.
Beispiel
Hinweis
Die folgenden Beispiele zeigen die Verwendung dieser Funktion in einem VBA-Modul (Visual Basic for Applications). Wenn Sie weitere Informationen zum Arbeiten mit VBA wünschen, wählen Sie Entwicklerreferenz in der Dropdownliste neben Suchen aus, und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
Die folgende Funktion gibt die durchschnittlichen Frachtkosten für Bestellungen zurück, die an oder nach einem bestimmten Datum versandt wurden. Der Bereich (Domäne) ist eine Tabelle für Bestellungen. Das Argument Kriterien schränkt den resultierenden Satz von Datensätzen basierend auf dem angegebenen Land/der angegebenen Region und dem Lieferdatum ein. Beachten Sie, dass das Schlüsselwort (keyword) in der Zeichenfolge enthalten ist, um die mehreren Felder im Argument Kriterien zu trennen. Alle Datensätze, die in die Berechnung der DAvg-Funktion einbezogen werden, weisen diese beiden Kriterien auf.
Public Function AvgFreightCost _
(ByVal strCountryRegion As String, _
ByVal dteShipDate As Date) As Double
AvgFreightCost = DAvg("[Freight]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & _
"'AND [ShippedDate] >= #" & dteShipDate & "#")
End Function
Verwenden Sie die folgende Codezeile im Direktfenster, um die Funktion aufzurufen:
:AvgFreightCost "UK", #1/1/96#