Compartilhar via

Application.DStDevP method (Access) (Método Application.DStDevP [Access])

Estima o desvio-padrão entre uma população num conjunto especificado de registos (um domínio).

Sintaxe

expressão. DStDevP (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, pode ser incorporada ou definida pelo utilizador, mas não outra agregação de domínio ou função de agregação 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 Variant Uma expressão de cadeia opcional utilizada para restringir o intervalo de dados no qual a função DStDevP é 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 DStDevP 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 DStDevP retornará um Null.

Valor de retorno

Variant

Comentários

Se o domínio se referir a menos de dois registos ou se menos de dois registos satisfizerem critérios, a função DStDevP devolve um Nulo, indicando que não é possível calcular um desvio padrão.

Utilize a função DStDevP para especificar critérios na linha Critérios de uma consulta selecionar. 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.

Utilize a função DStDevP numa expressão de campo calculado de uma consulta ou na linha Atualizar Para de uma consulta de atualização.

Observação

Utilize as funções DStDev e DStDevP ou as funções StDev e StDevP numa expressão de campo calculado 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.

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 DStDevP retornará um tipo de dados Double. Se você utilizar a função DStDevP 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 exemplo seguinte calcula as mesmas estimativas com a variável strCountry no argumento critérios . Tenha em atenção que as aspas únicas (') estão incluídas na expressão de cadeia, para que, quando as cadeias forem concatenadas, o literal UK de cadeia seja colocado entre aspas únicas.

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

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.

  • Last updated on