Метод Application.DStDevP (Access)

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

Синтаксис

выражение. DStDevP (выражение, домен, условия)

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

Параметры

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

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

Variant

Примечания

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

Используйте функцию DStDevP для указания условий в строке "Условия " запроса на выборку. Например, можно создать запрос в таблицах "Заказы" и "Товары", чтобы отобразить все товары, для которых стоимость доставки превышает среднюю с учетом стандартного отклонения.

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

Примечание.

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

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

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

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

Пример

В следующем примере возвращаются оценки стандартного отклонения для генеральной совокупности и выборка для заказов, отправленных в Соединенное Королевство. Домен представляет собой таблицу "Заказы". Аргумент условия ограничивает результирующий набор записей записями, для которых значением 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 в аргументе условия . Обратите внимание, что в строковое выражение включаются одинарные кавычки ('), так что при сцеплении строк строковый литерал 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 & "'")

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

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

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

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

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

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

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

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

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

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