Метод Application.DStDev (Access)

Статья
04/07/2023

Оценивает стандартное отклонение в выборке совокупности в указанном наборе записей (домене).

Синтаксис

expression. DStDev (expr, domain, criteria)

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Expr	Обязательный	String	Выражение, идентифицирующее числовое поле, для которого требуется найти стандартное отклонение. Это может быть строковое выражение, идентифицирующее поле из таблицы или запроса, или выражение, выполняющее вычисление данных в этом поле. В expr можно включить имя поля в таблицу, элемент управления в форме, константу или функцию. Если expr включает функцию, она может быть встроенной или определяемой пользователем, но не может быть другой агрегатной или агрегатной функцией SQL.
Домен	Обязательный	String	Строковое выражение, идентифицирующее набор записей, составляющих домен. Это может быть имя таблицы или имя запроса, который не требует параметра.
Criteria	Необязательный	Variant	Необязательное строковое выражение, используемое для ограничения диапазона данных, в котором выполняется функция DStDev . Например, критерии часто эквивалентны предложению WHERE в выражении SQL без слова WHERE. Если условие опущено, функция DStDev оценивает expr по всему домену. Любое поле, включенное в условия, также должно быть полем в домене; В противном случае функция DStDev вернет значение NULL.

Возвращаемое значение

Variant

Примечания

Например, можно использовать функцию DStDev в модуле для вычисления стандартного отклонения в наборе тестовых оценок учащихся.

Если домен ссылается на менее двух записей или меньше двух записей удовлетворяет критериям, функция DStDev возвращает значение NULL, указывающее, что стандартное отклонение невозможно вычислить.

Используйте функцию DStDev , чтобы указать критерии в строке Условия запроса на выборку. Например, можно создать запрос к таблицам Orders и Products, чтобы отобразить все товары, для которых стоимость фрахта упала выше среднего значения, а также стандартное отклонение от стоимости перевозки. Строка Условия под полем Freight будет содержать следующее выражение:

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

Используйте функцию DStDev в выражении вычисляемого поля запроса или в строке Обновить до запроса обновления.

Примечание.

Используйте функции DStDev и DStDevP или функции StDev и StDevP в вычисляемом выражении поля запроса итогов. При использовании функции DStDev или DStDevP значения вычисляются перед группировкой данных. При использовании функции StDev или StDevP данные группируются перед вычислением значений в выражении поля.

Используйте функцию DStDev в вычисляемом элементе управления, если необходимо указать критерии для ограничения диапазона данных, на которых выполняется функция. Например, чтобы отобразить стандартное отклонение для заказов, отправляемых в Калифорнию, задайте для свойства ControlSource текстового поля следующее выражение:

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

Если вы просто хотите найти стандартное отклонение для всех записей в домене, используйте функцию StDev или StDevP .

Если тип данных поля, из которого наследуется expr , является числом, функция DStDev возвращает тип данных Double . Если вы используете функцию DStDev в вычисляемом элементе управления, включите в выражение функцию преобразования типов данных, чтобы повысить производительность.

Пример

В следующем примере возвращаются оценки стандартного отклонения для генеральной совокупности и выборки для заказов, отправляемых в Соединенное Королевство. Домен — это таблица Orders. Аргумент условия ограничивает результирующий набор записей теми, для которых значение ShipCountry — ВЕЛИКОБРИТАНИЯ.

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

Следующий пример вычисляет те же оценки с помощью переменной strCountry в аргументе criteria . Обратите внимание, что в строковое выражение включаются одинарные кавычки ('), поэтому при объединии строк строковый литерал UK будет заключен в одинарные кавычки.

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 & "'")

В следующих примерах показано, как использовать различные типы условий с функцией DStDev .

    ' ***************************
    ' 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")
    ' ***************************

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Поделиться через