Application.DStDev-Methode (Access)

Schätzt die Standardabweichung für eine Populationsstichprobe in einem angegebenen Satz von Datensätzen (einer Domäne).

Syntax

Ausdruck. DStDev (Expr, Domain, Criteria)

expression Eine Variable, die ein Application-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Expr Erforderlich String Ein Ausdruck, der das numerische Feld identifiziert, für das Sie die Standardabweichung ermitteln möchten. Es kann sich um einen Zeichenfolgenausdruck handeln, der ein Feld aus einer Tabelle oder Abfrage identifiziert, oder es kann sich um einen Ausdruck handeln, der eine Berechnung für Daten in diesem Feld ausführt. In expr können Sie den Namen eines Felds in einer Tabelle, ein Steuerelement in einem Formular, eine Konstante oder eine Funktion einschließen. Wenn expr eine Funktion enthält, kann sie entweder integriert oder benutzerdefinierte sein, aber keine andere Domänenaggregat- oder SQL-Aggregatfunktion.
Domäne Erforderlich String Ein Zeichenfolgenausdruck, der die Gruppe der Datensätze angibt, die die Domäne bilden. Es kann sich dabei um einen Tabellennamen oder einen Abfragenamen für eine Abfrage handeln, die keinen Parameter benötigt.
Criteria Optional Variant Ein Zeichenfolgenausdruck, den Sie optional angeben können, um den Datenbereich einzuschränken, für den die Funktion DStDev ausgeführt wird. Beispielsweise ist criteria oft äquivalent mit der WHERE-Klausel in einem SQL-Ausdruck, ohne das Wort WHERE. Wird das Argument criteria nicht angegeben, so berechnet DStDev das Argument expr für die gesamte Domäne. Jedes Feld, das im Argument criteria enthalten ist, muss auch ein Feld des Arguments domain sein, sonst gibt die Funktion DStDev den Wert Null zurück.

Rückgabewert

Variant

Bemerkungen

Sie können z.B. die Funktion DStDev in einem Modul verwenden, um die Standardabweichung einer Gruppe von Testergebnissen von Studenten zu berechnen.

Wenn domäne auf weniger als zwei Datensätze verweist oder weniger als zwei Datensätze Kriterien erfüllen, gibt die DStDev-Funktion einen Null-Wert zurück, der angibt, dass eine Standardabweichung nicht berechnet werden kann.

Verwenden Sie die DStDev-Funktion , um Kriterien in der Zeile Kriterien einer Auswahlabfrage anzugeben. Sie können beispielsweise eine Abfrage für eine Tabelle Orders und eine Products-Tabelle erstellen, um alle Produkte anzuzeigen, für die die Frachtkosten über den Mittelwert gefallen sind, plus die Standardabweichung für die Frachtkosten. Die Zeile Kriterien unterhalb des Felds Fracht würde den folgenden Ausdruck enthalten:

>(DStDev("[Freight]", "Orders") + DAvg("[Freight]", "Orders"))

Verwenden Sie die DStDev-Funktion in einem berechneten Feldausdruck einer Abfrage oder in der Zeile Aktualisieren auf einer Updateabfrage.

Hinweis

Verwenden Sie die Funktionen DStDev und DStDevP oder die Funktionen StDev und StDevP in einem berechneten Feldausdruck einer Gesamtsummenabfrage. Wenn Sie DStDev oder DStDevP verwenden, werden die Werte berechnet, bevor die Daten gruppiert werden. Verwenden Sie StDev oder StDevP, werden die Daten gruppiert, bevor die Werte im Feldausdruck ausgewertet werden.

Verwenden Sie die DStDev-Funktion in einem berechneten Steuerelement, wenn Sie Kriterien angeben müssen, um den Datenbereich einzuschränken, in dem die Funktion ausgeführt wird. Um beispielsweise die Standardabweichung für Bestellungen anzuzeigen, die nach Kalifornien versendet werden sollen, legen Sie die ControlSource-Eigenschaft eines Textfelds auf den folgenden Ausdruck fest:

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

Möchten Sie lediglich die Standardabweichung aller Datensätze einer Domäne ermitteln, so verwenden Sie die Funktion StDev oder StDevP.

Wenn der Datentyp des Felds, von dem das Argument expr abgeleitet ist, eine Zahl ist, gibt die Funktion DStDev den Datentyp Double zurück. Wenn Sie die Funktion DStDev in einem berechneten Steuerelement verwenden, fügen Sie eine Datentyp-Konvertierungsfunktion in den Ausdruck ein, um das Leistungsverhalten zu verbessern.

Beispiel

Das folgende Beispiel gibt Schätzungen der Standardabweichung für eine Grundgesamtheit und eine Grundgesamtheitsstichprobe für Bestellungen zurück, die in das Vereinigte Königreich versendet werden. The domain is an Orders table. Das Argument criteria schränkt den resultierenden Satz von Datensätzen auf diejenigen ein, für die der ShipCountry-Wert UK ist.

Dim dblX As Double 
Dim dblY As Double 
 
' Sample estimate. 
dblX = DStDev("[Freight]", "Orders", "[ShipCountry] = 'UK'") 
 
' Population estimate. 
dblY = DStDevP("[Freight]", "Orders", "[ShipCountry] = 'UK'")

Im nächsten Beispiel werden die gleichen Schätzungen mithilfe der Variablen strCountry im Argument criteria berechnet. Beachten Sie, dass einfache Anführungszeichen (') im Zeichenfolgenausdruck enthalten sind, sodass beim Verketten der Zeichenfolgen das Zeichenfolgenliteral UK in einfache Anführungszeichen eingeschlossen wird.

Dim strCountry As String 
Dim dblX As Double 
Dim dblY As Double 
 
strCountry = "UK" 
 
dblX = DStDev("[Freight]", "Orders", _ 
    "[ShipCountry] = '" & strCountry & "'") 
 
dblY = DStDevP("[Freight]", "Orders", _ 
    "[ShipCountry] = '" & strCountry & "'")

Die folgenden Beispiele zeigen, wie verschiedene Arten von Kriterien mit der DStDev-Funktion verwendet werden.

    ' ***************************
    ' Typical Use
    ' Numerical values. Replace "number" with the number to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = number")

    ' Strings.
    ' Numerical values. Replace "string" with the string to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria]= 'string'")

    ' Dates. Replace "date" with the string to use.
    variable = DStDev("[FieldName]", "TableName", "[Criteria]= #date#")
    ' ***************************

    ' ***************************
    ' Referring to a control on a form
    ' Numerical values
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = " & Forms!FormName!ControlName)

    ' Strings
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = '" & Forms!FormName!ControlName & "'")

    ' Dates
    variable = DStDev("[FieldName]", "TableName", "[Criteria] = #" & Forms!FormName!ControlName & "#")
    ' ***************************

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DStDev("[FieldName]", "TableName", "[Criteria1] = " & Forms![FormName]![Control1] _
             & " AND [Criteria2] = '" & Forms![FormName]![Control2] & "'" _
            & " AND [Criteria3] =#" & Forms![FormName]![Control3] & "#")
    
    ' Use two fields from a single record.
    variable = DStDev("[LastName] & ', ' & [FirstName]", "tblPeople", "[PrimaryKey] = 7")
            
    ' Expressions
    variable = DStDev("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")
    
    ' Control Structures
    variable = DStDev("IIf([LastName] Like 'Smith', 'True', 'False')", "tableName", "[PrimaryKey] = 7")
    ' ***************************

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.