Método Application.DStDev (Access)

Estima o desvio padrão em um exemplo de preenchimento de um conjunto de registros especificado (um domínio).

Sintaxe

expressão. DStDev (Expr, Domínio, Critérios)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Expr	Obrigatório	String	Uma expressão que identifica o campo numérico no qual você deseja encontrar o desvio padrão. Pode ser uma expressão de cadeia de caracteres que identifique um campo de uma tabela ou consulta ou pode ser uma expressão que efetue cálculos nos dados desse campo. Na expr, você pode incluir o nome de um campo em uma tabela, um controle em um formulário, em uma constante ou em uma função. Se expr incluir uma função, ela poderá ser interna ou definida pelo usuário, mas não outra função de agregação de domínio ou de agregação de SQL.
Domínio	Obrigatório	String	Uma expressão formada por cadeia de caracteres que identifica o conjunto de registros que constitui o domínio. Pode ser um nome de tabela ou um nome de uma consulta que não exija um parâmetro.
Criteria	Opcional	Variantes	Uma expressão de cadeia de caracteres opcional utilizada para restringir o intervalo de dados no qual a função DStDev é executada. Por exemplo, criteria com frequência é equivalente à cláusula WHERE em uma expressão SQL, sem a palavra WHERE. Se criteria for omitido, a função DStDev avaliará expr em relação ao domínio inteiro. Qualquer campo incluído em criteria deve ser também um campo no domain, caso contrário a função DStDev retornará um Null.

Valor de retorno

Variant

Comentários

Você poderia, por exemplo, utilizar a função DStDev em um módulo para calcular o desvio padrão em um conjunto de notas de avaliação de alunos.

Se o domínio se referir a menos de dois registros ou se menos de dois registros atenderem aos critérios, a função DStDev retornará um Null, indicando que um desvio padrão não pode ser calculado.

Use a função DStDev para especificar critérios na linha Critérios de uma consulta selecionada. Você poderia, por exemplo, criar uma consulta sobre uma tabela Orders e uma tabela Products para exibir todos os produtos para os quais o custo do frete ficou acima da média mais o desvio padrão para o custo do frete. A linha Critérios abaixo do campo Freight conteria a seguinte expressão:

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

Use a função DStDev em uma expressão de campo calculada de uma consulta ou na linha Atualizar para de uma consulta de atualização.

Observação

Use as funções DStDev e DStDevP ou as funções StDev e StDevP em uma expressão de campo calculada de uma consulta de totais. Se você utilizar a função DStDev ou DStDevP, os valores serão calculados antes de os dados serem agrupados. Se você utilizar a função StDev ou StDevP, os dados serão agrupados antes de os valores serem avaliados na expressão do campo.

Utilize a função DStDev em um controle calculado quando precisar especificar critérios para restringir o intervalo de dados no qual a função é executada. Por exemplo, para exibir o desvio padrão para que os pedidos sejam enviados para a Califórnia, defina a propriedade ControlSource de uma caixa de texto para a seguinte expressão:

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

Se você deseja simplesmente encontrar o desvio padrão de todos os registros em domain, utilize a função StDev ou StDevP.

Se o tipo de dados do campo do qual expr é derivado for um número, a função DStDev retornará um tipo de dados Double. Se você usa a função DStDev em um controle calculado, inclua uma função de conversão de tipo de dados na expressão para melhorar o desempenho.

Exemplo

O exemplo a seguir retorna estimativas do desvio padrão de uma população e uma amostra de população para pedidos enviados para o Reino Unido. O domínio é uma tabela Orders. O argumento criteria restringe o conjunto de registros resultante àqueles para os quais o ShipCountry é UK.

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

O próximo exemplo calcula as mesmas estimativas usando a variável strCountry no argumento de critérios . Observe que as aspas individuais (') são incluídas na expressão de cadeia de caracteres, de modo que, quando as cadeias de caracteres forem concatenadas, o literal UK da cadeia de caracteres será incluído em aspas individuais.

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

Os exemplos a seguir mostram como usar vários tipos de critérios com a função 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")
    ' ***************************

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.