Função DAvg

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar a função DAvg para calcular a média de um conjunto de valores em um conjunto específico de registros (um domínio ). Use a função DAvg em um módulo Visual Basic for Applications (VBA), em um macro, em uma expressão de consulta ou em um controle calculado.

Por exemplo, você pode usar a função DAvg na linha critérios de uma consulta seleção sobre custo de frete para restringir os resultados aos registros onde o custo de frete excede a média. Ou você pode usar uma expressão incluindo a função DAvg em um controle calculado e exibir o valor médio de pedidos anteriores ao lado do valor de um novo pedido.

Sintaxe

DAvg ( expr domínio [critérios] )

A sintaxe da função DAvg possui os seguintes argumentos:

Argumento

Descrição

expr

Necessário. Uma expressão que identifica o campo que contém os dados numéricos que você deseja média. Pode ser uma expressão de cadeia de caracteres que identifica um campo em uma tabela ou consulta ou pode ser uma expressão que executa um cálculo nos dados desse campo. Em expr, você pode incluir o nome de um campo em uma tabela, um controle em um formulário, uma constante ou uma função. Se expr inclui uma função, pode ser interno ou definida pelo usuário, mas não outro domínio agregado ou função SQL agregada.

domínio

Necessá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 exige 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 DAvg é executada. Por exemplo, critérios costuma ser equivalente à cláusula WHERE em uma expressão SQL, sem a palavra onde. Se critérios for omitido, a função DAvg avalia expr em relação ao domínio inteiro. Qualquer campo que está incluído em criterium também deve ser um campo no domínio; Caso contrário, retorna a função DAvg uma nulo.


Comentários

Registros que contêm valores Nulos não são incluídos no cálculo da média.

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

Você pode usar a função DAvg para especificar critérios na linha critérios de uma consulta. Por exemplo, suponha que você deseja exibir uma lista de todos os produtos pedidos em quantidades acima da quantidade média dos pedidos. Você pode criar uma consulta nas tabelas Pedidos, detalhes do pedido e produtos e incluir o campo de nome de produto e o campo Quantity, com a seguinte expressão na linha critérios abaixo do campo Quantity:

>DAvg("[Quantity]", "Orders")

Você também pode usar a função DAvg dentro de uma expressão de campo calculado em uma consulta ou na linha Atualizar para de uma atualizar consulta.

Observação : Você pode usar a DAvgAvg função ou em uma expressão de campo calculado em uma consulta de totais. Se você usar a função DAvg , valores média são calculadas antes dos dados serem agrupados. Se você usar a função média , os dados serão agrupados antes de que são média de valores na expressão do campo.

Use a função DAvg em um controle calculado quando você precisar especificar critérios para restringir o intervalo de dados no qual a função DAvg é executada. Por exemplo, para exibir o custo médio de frete para entregas enviadas para a Califórnia, defina a propriedade OrigemDoControle de uma caixa de texto com a seguinte expressão:

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

Se você deseja simplesmente média de todos os registros do domínio, use a função média .

Você pode usar a função DAvg em um módulo ou macro ou em um controle calculado em um formulário se um campo que você precisa exibir não estiver na fonte de registro no qual seu formulário está baseado. Por exemplo, suponha que você tenha um formulário baseado na tabela Pedidos e você deseja incluir o campo Quantidade da tabela Detalhes do pedido para exibir o número médio de itens pedidos por um determinado cliente. Você pode usar a função DAvg para executar esse cálculo e exibir os dados em seu formulário.

Dicas

  • Se você usar a função DAvg em um controle calculado, você talvez queira colocar o controle no formulário cabeçalho ou rodapé para que o valor para esse controle não seja recalculado a cada vez que você mover para um novo registro.

  • Se o tipo de dados do campo do qual expr é derivado for um número, a função DAvg retorna um tipo de dados duplo. Se você usar a função DAvg em um controle calculado, inclua uma função de conversão de tipo de dados na expressão para melhorar o desempenho.

  • Embora você possa usar a função DAvg para determinar a média dos valores em um campo em uma tabela estrangeira, talvez seja mais eficiente para criar uma consulta que contém todos os campos que você precisa e, em seguida, basear seu formulário ou relatório nessa consulta.

Observação : Alterações não salvas em registros do domínio não são incluídas quando você usa esta função. Se desejar que a função DAvg seja baseado nos valores alterados, você deve primeiro salvar as alterações clicando em Salvar registro em registros na guia dados , movendo o foco para um outro registro ou usando o método de atualização .

Exemplo

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

A função a seguir retorna o custo de frete médio de pedidos enviados em ou após uma determinada data. O domínio é uma tabela Pedidos. O argumento de critérios restringe o conjunto de registros com base em determinada data país/região e navio resultante. Observe que a palavra-chave e é incluída na cadeia de caracteres para separar os vários campos no argumento de critérios . Todos os registros incluídos no cálculo da função DAvg terão que esses dois critérios.

Public Function AvgFreightCost _
(ByVal strCountryRegion As String, _
ByVal dteShipDate As Date) As Double
AvgFreightCost = DAvg("[Freight]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & _
"'AND [ShippedDate] >= #" & dteShipDate & "#")
End Function

Para chamar a função, use a seguinte linha de código na janela imediata:

:AvgFreightCost "UK", #1/1/96#

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
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.

×