Função DSum

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 DSoma para calcular a soma de um conjunto de valores em um conjunto específico de registros (um domínio ). Use a função DSoma em um Visual Basic for Applications (VBA) módulo, um macro, uma expressão de consulta ou um controle calculado.

Por exemplo, você pode usar a função DSoma em uma expressão de campo calculado em uma consulta para calcular o total de vendas feitas por um determinado funcionário durante um período de tempo. Ou, você pode usar a função DSoma em um controle calculado para exibir uma soma parcial das vendas de um produto específico.

Sintaxe

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

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

Argumento

Descrição

expr

Necessário. Uma expressão que identifica o valor numérico campo cujos valores você deseja totalizar. 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 DSoma é 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 DSoma avalia expr em relação ao domínio inteiro. Qualquer campo que está incluído nos critérios também deve ser um campo no domínio; Caso contrário, retorna a função DSoma um nulo.


Comentários

Se nenhum registro satisfizer o argumento de critérios ou domínio não contém registros, a função DSoma retornará um valor nulo.

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

Você pode usar a função DSoma para especificar critérios na linha critérios de uma consulta, em um campo calculado em uma expressão de consulta ou na linha Atualizar para de uma atualizar consulta.

Observação: Você pode usar a função DSoma ou a soma de função em uma expressão de campo calculado em uma consulta de totais. Se você usar a função DSoma , os valores são calculados antes de dados serem agrupados. Se você usar a função soma , os dados serão agrupados antes dos valores na expressão do campo são avaliados.

Talvez você queira usar a função DSoma quando precisar exibir a soma de um conjunto de valores de um campo que não esteja na fonte de registro de seu formulário ou relatório. Por exemplo, suponha que você tenha um formulário que exibe informações sobre um produto específico. Você pode usar a função DSoma para manter uma soma total de vendas de produto em um controle calculado.

Dica

Se você precisar manter uma soma acumulada em um controle em um relatório, você pode usar a propriedade SomaParcial desse controle, se o campo no qual ele se baseia está incluído na fonte de registro para o relatório. Use a função DSoma para manter uma soma parcial em um formulário.

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

Exemplos

Use a função DSoma em uma expressão    Você pode usar uma função de domínio (como DSoma) na linha Atualizar para de uma consulta atualização. Por exemplo, suponha que você queira controlar atual de vendas por produto em uma tabela produtos. Você pode adicionar um novo campo denominado VendasAtéAgora à tabela Produtos e executar uma consulta de atualização para calcular os valores corretos e atualizar os registros. Para fazer isso, crie uma nova consulta baseada na tabela Produtos e, na guia Design, no grupo Tipo de consulta, clique em Atualizar. Adicione o campo VendasAtéAgora à grade da consulta e digite o seguinte na linha Atualizar para:

DSum("[Quantity]*[UnitPrice]", "Order Details", _
"[ProductID] = "& [ProductID])

Quando você executa a consulta, o Access calcula a quantidade total de vendas para cada produto, com base nas informações de uma tabela de detalhes do pedido. A soma das vendas para cada produto é adicionada à tabela produtos.

Use DSoma no código VBA   

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.

O exemplo a seguir totaliza os valores do campo Freight de pedidos enviados para o Reino Unido. O domínio é uma tabela Pedidos. O argumento de critérios restringe o conjunto de registros resultante para os quais ShipCountryRegion é igual a Reino Unido.

Dim curX As Currency
curX = DSum("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")

O exemplo a seguir calcula o total usando dois critérios separados. Observe que aspas simples (') e sinais de número (#) é incluído na expressão de cadeia de caracteres, para que quando as cadeias de caracteres são concatenadas, a cadeia de caracteres literal está entre aspas simples e a data está entre sinais de cerquilha.

Dim curX As Currency
curX = DSum("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK' AND _
[ShippedDate] > #1-1-95#")

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.

×