Funções DMin e DMax

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 as funções DMin e DMax para determinar os valores mínimos e máximos em um conjunto específico de registros (um domínio ). Use as funções DMin e DMax 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 as funções DMin e DMax em controles calculados em um relatório para exibir as menor e maior quantidades de pedidos para um determinado cliente. Ou você pode usar a função BDMÍN em uma expressão de consulta para exibir todos os pedidos com um desconto maior do que o desconto mínimo possível.

Sintaxe

BDMÍN ( expr domínio [critérios] )

BDMÁX ( expr domínio [critérios] )

As funções DMin e DMax têm estes argumentos:

Argumento

Descrição

expr

Necessário. Uma expressão que identifica o campo para o qual você deseja encontrar o valor mínimo ou máximo. 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 BDMÍN ou BDMÁX é 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, as funções DMin e DMax avaliam 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, as funções DMin e DMax retorna um nulo.


Comentários

As funções DMin e DMax retornam os valores mínimos e máximos que satisfazem critérios. Se expr identificar dados numéricos, as funções DMin e DMax retornam valores numéricos. Se expr identificar dados de cadeia de caracteres, eles retornaram a cadeia de caracteres que for a primeira ou última em ordem alfabética.

As funções DMin e DMax ignoram valores Nulos no campo referido por expr. No entanto, se nenhum registro satisfizer os critérios ou se domínio não contiver registros, as funções DMin e DMax retornaram Nulo.

Se você usar a função BDMÍN ou BDMÁX 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 DMin e DMax para especificar critérios na linha critérios de uma consulta, em uma expressão de campo calculado em uma consulta ou na linha Atualizar para de uma atualizar consulta.

Observação : Você pode usar as funções DMin e DMax ou as funções mínimo e máximo em uma expressão de campo calculado de uma consulta de totais. Se você usar a função BDMÍN ou BDMÁX , valores serão avaliados antes dos dados serem agrupados. Se você usar a função Mín ou Máx , os dados serão agrupados antes dos valores na expressão do campo são avaliados.

Use a função BDMÍN ou BDMÁX em um controle calculado quando você precisar especificar critérios para restringir o intervalo de dados no qual a função é executada. Por exemplo, para exibir o frete máximo cobrado para um pedido enviado para a Califórnia, defina a propriedade OrigemDoControle de uma caixa de texto com a seguinte expressão:

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

Se você deseja simplesmente encontrar o valor mínimo ou máximo de todos os registros no domínio, use a função Mín ou Máx .

Você pode usar a função BDMÍN ou BDMÁX em um módulo ou macro ou em um controle calculado em um formulário se o campo que você precisa exibir não estiver na fonte de registro no qual seu formulário está baseado.

Dica

Embora você possa usar a função BDMÍN ou BDMÁX para localizar o valor mínimo ou máximo de um campo em uma tabela estrangeira, talvez seja mais eficiente para criar uma consulta que contém os campos que você precisa de ambas as tabelas e basear o 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 essas funções. Se desejar que a função BDMÁX ou BDMÍN 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.

O exemplo a seguir retorna os valores mais altos e mais baixos 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
Dim curY As Currency
curX = DMin("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")
curY = DMax("[Freight]", "Orders", _
"[ShipCountryRegion] = 'UK'")

No próximo exemplo, o argumento de critérios inclui o valor atual de uma caixa de texto denominada DataDoPedido. Na caixa de texto está vinculada a um campo OrderDate em uma tabela Pedidos. Observe que a referência ao controle não está incluída nas aspas duplas (") que indicam as sequências. Isso garante que cada vez que a função BDMÁX é chamada, Microsoft Office Access 2007 obterá o valor atual do controle.

Dim curX As Currency
curX = DMax("[Freight]", "Orders", "[OrderDate] = #" _
& Forms!Orders!OrderDate & "#")

No próximo exemplo, a expressão de critério inclui uma variável, dteOrderDate. Observe que os sinais de número (#) são incluídos na expressão de cadeia de caracteres, para que quando as cadeias de caracteres são concatenadas, eles serão Circunscrever a data.

Dim dteOrderDate As Date
Dim curX As Currency
dteOrderDate = #03/30/2000#
curX = DMin("[Freight]", "Orders", _
"[OrderDate] = #" & dteOrderDate & "#")

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.

×