DCont (función)

Importante:  Este artículo se ha traducido con traducción automática; vea la declinación de responsabilidades. Para su referencia, puede encontrar la versión en inglés de este artículo aquí.

Puede usar la función DCount para determinar el número de registros que están en un conjunto especificado de registros (una dominio ). Use la función DCount en un Visual Basic para aplicaciones (VBA) módulo, un macro, una expresión de consulta o un control calculado.

Por ejemplo, podría usar la función DCount en un módulo para devolver el número de registros en una tabla pedidos que corresponde a pedidos colocados en una fecha determinada.

Sintaxis

BDCONTAR ( expr dominio [criterios] )

La sintaxis de la función BDCONTAR tiene los siguientes argumentos:

Argumento

Descripción

expresión

Obligatorio. Una expresión que identifica el campo que desea contar registros. Puede ser un expresión de cadena identifica un campo de una tabla o consulta, o puede ser una expresión que realiza un cálculo con los datos de ese campo. En expr, puede incluir el nombre de un campo en una tabla, un control de un formulario, una constante o una función. Si expr incluye una función, puede ser agregado de dominio integrado o definidas por el usuario, pero no o función de agregado de SQL.

dominio

Obligatorio. Una expresión de cadena que identifica el conjunto de registros que constituye el dominio. Puede ser un nombre de tabla o un nombre de consulta para una consulta que no requiere un parámetro.

criterios

Opcional. Expresión de cadena que se utiliza para restringir el intervalo de datos en el que se ejecuta la función DCount . Por ejemplo, criterios con frecuencia es equivalente a la cláusula WHERE en una expresión SQL, sin la palabra donde. Si se omite criterios , la función DCount evalúa expr para todo el dominio. Cualquier campo que se incluya en criterios debe ser también un campo de dominio; en caso contrario, la función DCount devuelve un nulo.


Observaciones

Use la función DCount para contar el número de registros en un dominio cuando no necesite conocer sus valores particulares. Aunque el argumento expr puede realizar un cálculo en un campo, la función DCount sencillamente cuenta el número de registros. Los valores de los cálculos realizados por expr está disponible.

Use la función DCount en un control calculado cuando necesite especificar criterios para restringir el intervalo de datos en el que se ejecuta la función. Por ejemplo, para mostrar el número de pedidos que se van a enviar a California, establezca la propiedad derce de ControlSouun cuadro de texto en la siguiente expresión:

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

Si simplemente desea contar todos los registros del dominio sin especificar ninguna restricción, utilice la función contar .

Sugerencia

La función Count se ha optimizado para acelerar el recuento de registros en las consultas. Use la función contar en una expresión de consulta en lugar de la función DCount y establezca criterios opcionales para aplicar restricciones a los resultados. Use la función DCount cuando deba contar los registros en un dominio desde un módulo de código o una macro, o en un control calculado.

Puede usar la función DCount para contar el número de registros que contienen un campo concreto que no está en el origen de registros del formulario o informe. Por ejemplo, puede mostrar el número de pedidos en la tabla pedidos en un control calculado en un formulario basado en la tabla productos.

La función DCount no cuenta los registros que contengan valores nulos en el campo que expr hace referencia a menos que expr sea el carácter comodín asterisco (*). Si utiliza un asterisco, la función DCount calcula el número total de registros, incluidos los que contienen campos Null . En el ejemplo siguiente se calcula el número de registros en una tabla Pedidos.

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

Si el dominio es una tabla con un clave principal, también puede contar el número total de registros estableciendo expr en el campo de clave principal, ya que nunca habrá un Null en el campo de clave principal.

Si expr identifica varios campos, separe los nombres de campo con un operador de concatenación, ya sea una y comercial (&) o el signo más (+). Si usa una y comercial para separar los campos, la función DCount devuelve el número de registros que contienen datos en cualquiera de los campos mostrados. Si usa el operador de suma, la función DCount devuelve solo el número de registros que contienen datos en todos los campos mostrados. En el ejemplo siguiente se muestra los efectos de cada operador cuando se utiliza con un campo que contiene datos en todos los registros (NombreEnvío) y un campo que no contiene datos (RegiónEnvío).

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

Nota: La y comercial es el operador preferido para realizar concatenación de cadenas. Debe evitar el uso del operador de suma para cualquier cosa que no sea la suma de números, a menos que desee propagar nulas a través de una expresión específicamente.

Los cambios no guardados en registros de dominio no se incluyen al usar esta función. Si desea que la función DCount se base en los valores modificados, primero debe guardar los cambios haciendo clic en Guardar registro en registros en la ficha datos , mover el enfoque a otro registro o utilizando el método deesobre actualización.

Ejemplo

Nota: Los ejemplos siguientes muestran el uso de esta función en un Visual Basic para aplicaciones (VBA). Para obtener más información sobre cómo trabajar con VBA, seleccione la Referencia del programador en la lista desplegable situada junto a Buscar y escriba uno o varios términos en el cuadro de búsqueda.

La siguiente función devuelve el número de pedidos enviados a un país o región especificada después de una fecha de envío especificada. El dominio es la tabla 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 llamar a la función, utilice la siguiente línea de código en la ventana Inmediato:

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

Nota: Declinación de responsabilidades de traducción automática: Este artículo se ha traducido con un sistema informático sin intervención humana. Microsoft ofrece estas traducciones automáticas para que los hablantes de otros idiomas distintos del inglés puedan disfrutar del contenido sobre los productos, los servicios y las tecnologías de Microsoft. Puesto que este artículo se ha traducido con traducción automática, es posible que contenga errores de vocabulario, sintaxis o gramática.

Ampliar sus conocimientos
Explorar los cursos
Obtener nuevas características primero
Únase a los participantes de Office Insider

¿Le ha sido útil esta información?

¡Gracias por sus comentarios!

Gracias por sus comentarios. Quizá le interese ponerse en contacto con uno de nuestros agentes de soporte de Office.

×