Função DCount

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 BDCONTAR para determinar o número de registros que estão em um conjunto especificado de registros (um domínio ). Use a função BDCONTAR 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 BDCONTAR em um módulo para retornar o número de registros em uma tabela de pedidos que correspondem aos pedidos feitos em uma determinada data.

Sintaxe

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

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

Argumento

Descrição

expr

Necessário. Uma expressão que identifica o campo para o qual você deseja contar registros. 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 BDCONTAR é 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 BDCONTAR 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 BDCONTAR um nulo.


Comentários

Use a função BDCONTAR para contar o número de registros em um domínio quando você não precisa conhecer seus valores específicos. Embora o argumento expr possa efetuar um cálculo em um campo, a função BDCONTAR simplesmente conta o número de registros. O valor de qualquer cálculo efetuado por expr não está disponível.

Use a função BDCONTAR 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 número de pedidos a serem enviados para a Califórnia, defina a propriedade derceControlSoude uma caixa de texto com a seguinte expressão:

=DCount("[OrderID]", "Orders", "[ShipRegion] = 'CA'")

Se você deseja simplesmente contar todos os registros no domínio sem especificar qualquer restrição, use a função Cont .

Dica

A função Contar foi otimizada para acelerar a contagem de registros em consultas. Usar a função contar em uma expressão de consulta em vez da função BDCONTAR e defina critérios opcionais para impor restrições nos resultados. Use a função BDCONTAR quando precisar contar registros em um domínio de dentro de um módulo de código ou macro ou em um controle calculado.

Você pode usar a função BDCONTAR para contar o número de registros que contêm um determinado campo que não está na fonte de registro no qual seu formulário ou relatório é baseado. Por exemplo, você pode exibir o número de pedidos na tabela Pedidos em um controle calculado em um formulário baseado na tabela produtos.

A função BDCONTAR não conta registros que contêm valores Nulos no campo referido por expr , a menos que expr seja o caractere curinga asterisco (*). Se você usar um asterisco, a função BDCONTAR calcula o número total de registros, inclusive aqueles que contêm campos Nulo . O exemplo a seguir calcula o número de registros em uma tabela Pedidos.

intX = DCount("*", "Orders")

Se o domínio é uma tabela com um chave primária, você também pode contar o número total de registros definindo expr o campo de chave primária, desde que nunca haverá um Nulo no campo de chave primária.

Se expr identificar vários campos, separe os nomes de campo com um operador de concatenação, seja um e comercial (&) ou o operador de adição (+). Se você usar um e comercial para separar os campos, a função BDCONTAR retorna o número de registros que contêm dados em qualquer um dos campos listados. Se você usar o operador de adição, a função BDCONTAR retorna apenas o número de registros que contêm dados em todos os campos listados. O exemplo a seguir demonstra os efeitos de cada operador quando utilizado com um campo que contém dados em todos os registros (ShipName) e um campo que não contém dados (ShipRegion).

intW = DCount("[ShipName]", "Orders")
intX = DCount("[ShipRegion]", "Orders")
intY = DCount("[ShipName] + [ShipRegion]", "Orders")
intZ = DCount("[ShipName] & [ShipRegion]", "Orders")

Observação : O e comercial é o operador preferido para realizar concatenação de cadeia de caracteres. Evite usar o operador de adição para qualquer coisa diferente de adição numérica, a menos que você queira especificamente propagar Nulos através de uma expressã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 BDCONTAR 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 deeatualiza.

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 número de pedidos enviados para um país/região especificado após uma data de envio especificada. O domínio é uma tabela Pedidos.

Public Function OrdersCount _
(ByVal strCountryRegion As String, _
ByVal dteShipDate As Date) As Integer
OrdersCount = DCount("[ShippedDate]", "Orders", _
"[ShipCountryRegion] = '" & strCountryRegion & _
"' AND [ShippedDate] > #" & dteShipDate & "#")
End Function

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

:OrdersCount "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.

×