Funções DVar, DVarP

Você pode usar as funções DVar e DVarP para estimar a variação em um conjunto de valores em um conjunto de registros especificado (um domínio ). Use as funções DVar e DVarP em um módulo do Visual Basic for Applications (VBA), uma macro, uma expressão de consulta ou uma controle calculado em um formulário ou relatório.

Use a função DVarP para avaliar a variação em uma população e a função DVar para avaliar a variação em uma amostra de população.

Por exemplo, você pode usar a função DVar para calcular a variação em um conjunto de resultados de teste dos alunos.

Sintaxe

DVar ( expr , domínio [, critérios] )

DVarP ( expr , domínio [, critérios] )

As funções DVar e DVarP têm os seguintes argumentos:

Argumento

Descrição

expr

Obrigatório. Uma expressão que identifica o campo numérico no qual você deseja encontrar a variação. Pode ser uma expressão de cadeia de caracteres identificar um campo de uma tabela ou consulta, ou pode ser uma expressão que executa um cálculo nos dados desse campo. No exemploPR, você pode incluir o campo nome em uma tabela, um controle em um formulário, uma constante ou uma função. Se expr incluir uma função, ela poderá ser interna ou definida pelo usuário, mas não outra agregação de domínio ou função agregada SQL. Qualquer campo incluído em expr deve ser um campo numérico.

domínio

Obrigatório. Uma expressão de cadeia de caracteres que identifica o conjunto de registros que constitui o domínio. Pode ser um nome de tabela ou um nome de consulta para uma consulta que não exija um parâmetro.

critérios

Opcional. Uma expressão de cadeia de caracteres usada para restringir o intervalo de dados no qual a função DVar ou DVarP é executada. Por exemplo, os critérios geralmente são equivalentes à cláusula WHERE em uma expressão SQL, sem a palavra Where. Se critérios forem omitidos, as funções DVar e DVarP avaliarão expr em relação a todo o domínio. Qualquer campo incluído nos critérios também deve ser um campo no domínio; caso contrário, as funções DVar e DVarP retornarão um NULL.

Comentários

Se o domínio fizer referência a menos de dois registros ou menos de dois registros satisfizerem o criteria, as funções DVar e DVarP retornarão um NULL, indicando que uma variação não pode ser calculada.

Não importa se você usa a função DVar ou DVarP em uma macro, um módulo, uma expressão de consulta ou um controle calculado, deve construir cuidadosamente o argumento de critérios para garantir que ele será avaliado corretamente.

Você pode usar a função DVar e DVarP para especificar critérios na linha critérios de uma consulta seleção, em uma expressão de campo calculado em uma consulta ou na linha atualizar para de uma consulta atualização.

Observação: Você pode usar as funções DVar e DVarP ou as funções var e VARP em uma expressão de campo calculado em um consulta de totais. Se você usar a função DVar ou DVarP , os valores serão calculados antes de os dados serem agrupados. Se você usar a função var ou VARP , os dados serão agrupados antes que os valores na expressão do campo sejam avaliados.

Use as funções DVar e DVarP em um controle calculado quando você precisa especificar critérios para restringir o intervalo de dados no qual a função é realizada. Por exemplo, para exibir uma variação dos pedidos a serem enviados para a Califórnia, defina a propriedade OrigemDoControle de uma caixa de texto como a seguinte expressão:

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

Se você quiser simplesmente localizar o desvio padrão em todos os registros no domínio, use a função var ou VARP .

Observação: As alterações não salvas nos registros no domínio não são incluídas quando você usa essas funções. Se quiser que a função DVar ou DVarP se baseie nos valores alterados, primeiro você deve salvar as alterações clicando em salvar registro em registros na guia dados , movendo o foco para outro registro ou usando o botão Método Update .

Exemplo de consulta

Expressão

Resultados

Selecione DVar ("PreçoUnitário", "productSales", "preço unitário>140") como DVar_Value, DVarP ("PreçoUnitário", "productSales", "PreçoUnitário<140") como DVarP_Value de productSales agrupar por DVar ("PreçoUnitário", "productSales", "PreçoUnitário>140"), DVarP ("PreçoUnitário", "productSales", "PreçoUnitário<140");

Calcula a variação de "PreçoUnitário" da tabela "ProductSales", em que "PreçoUnitário" é maior do que 140 e exibe o resultado em DVar_Value. Também calcula a variação de "PreçoUnitário" (considerando os dados fornecidos como população inteira) em que "PreçoUnitário" é menor do que 140 e exibe os resultados em DVarP_Value.

Exemplos do VBA

Observação: Exemplos a seguir demonstram o uso dessa função em um módulo do Visual Basic for Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione referência do desenvolvedor na lista suspensa ao lado de Pesquisar e insira um ou mais termos na caixa de pesquisa.

O exemplo a seguir retorna estimativas da variação de uma população e uma amostra de população para os pedidos enviados para o Reino Unido. O domínio é uma tabela pedidos. O argumento critérios restringe o conjunto de registros resultante àqueles para os quais ShipCountryRegion é igual a Reino Unido.

Dim dblX As Double
Dim dblY As Double
' Sample estimate.
dblX = DVar("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")
' Population estimate.
dblY = DVarP("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")

O próximo exemplo retorna estimativas usando uma variável, strCountryRegion, no argumento de critérios . Observe que as aspas simples (') são incluídas na expressão de cadeia de caracteres, de modo que, quando as cadeias de caracteres são concatenadas, a cadeia de caracteres literal UK será colocada entre aspas simples.

Dim strCountryRegion As String
Dim dblX As Double
strCountryRegion = "UK"
dblX = DVar("[Freight]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & "'")

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×