Método Application.DVarP (Access)

Calcula la varianza de una población en un conjunto de registros especificado (dominio).

Sintaxis

expresión. DVarP (Expr, Domain, Criteria)

expresión Variable que representa un objeto Application.

Parámetros

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Expr	Obligatorio	String	Expresión que identifica el campo numérico en el que se desea buscar la varianza. Puede ser una expresión de cadena que identifica un campo de una tabla o consulta, o bien, una expresión que realiza un cálculo con los datos de ese campo. En Expr, puede incluir el nombre de un campo de una tabla, un control de un formulario, una constante o una función. Si expr incluye una función, puede ser integrada o definida por el usuario, pero no otra función de agregado de dominio o de agregado de SQL. Todo campo incluido en Expr debe ser un campo numérico.
Dominio	Obligatorio	String	Una expresión de cadena que identifica el conjunto de registros que constituyen el dominio. Puede ser un nombre de tabla o de consulta para una consulta que no requiere ningún parámetro.
Criteria	Opcional	Variant	Una expresión de cadena opcional que se utiliza para restringir el intervalo de datos sobre el que se ejecuta la función DVarP. Por ejemplo, criteria suele ser equivalente a la cláusula WHERE en una expresión SQL, sin la palabra WHERE. Si se omite criteria, la función DVarP evalúa expr para todo el dominio. Cualquier campo incluido en los criterios también debe ser un campo en el dominio; De lo contrario, la función DVarP devuelve un valor Null.

Valor devuelto

Variant

Comentarios

Si dominio hace referencia a menos de dos registros, o si menos de dos registros cumplen los criterios, las funciones DVarP devuelven un valor Null, lo que indica que no se puede calcular una varianza.

Tanto si usa la función DVarP en una macro, módulo, expresión de consulta o control calculado, debe construir el argumento criteria cuidadosamente para asegurarse de que se evaluará correctamente.

Use la función DVarP para especificar criterios en la fila Criterios de una consulta de selección, en una expresión de campo calculada en una consulta o en la fila Actualizar a de una consulta de actualización.

Nota:

Use la función DVarP o la función VarP en una expresión de campo calculada en una consulta de totales. Si usa la función DVarP, los valores se calculan antes de que se agrupen los datos. Si usa la función VarP, los datos se agrupan antes de que se evalúen los valores de la expresión del campo.

Si simplemente desea obtener la desviación estándar de todos los registros de domain, use la función Var o VarP.

Ejemplo:

En este ejemplo se devuelven estimaciones de la varianza de una población y una muestra de población para los pedidos enviados al Reino Unido (UK). El dominio es la tabla denominada Orders (Pedidos). El argumento criteria restringe el conjunto de registros resultante a aquéllos para los que el valor de ShipCountry (País de envío) es UK.

Dim dblX As Double 
Dim dblY As Double 
 
' Sample estimate. 
dblX = DVar("[Freight]", "Orders", "[ShipCountry] = 'UK'") 
 
' Population estimate. 
dblY = DVarP("[Freight]", "Orders", "[ShipCountry] = 'UK'")

En los ejemplos siguientes se muestra cómo usar varios tipos de criterios con la función DVarP .

    ' ***************************
    ' Typical Use
    ' Numerical values. Replace "number" with the number to use.
    variable = DVarP("[FieldName]", "TableName", "[Criteria] = number")

    ' Strings.
    ' Numerical values. Replace "string" with the string to use.
    variable = DVarP("[FieldName]", "TableName", "[Criteria]= 'string'")

    ' Dates. Replace "date" with the string to use.
    variable = DVarP("[FieldName]", "TableName", "[Criteria]= #date#")
    ' ***************************

    ' ***************************
    ' Referring to a control on a form
    ' Numerical values
    variable = DVarP("[FieldName]", "TableName", "[Criteria] = " & Forms!FormName!ControlName)

    ' Strings
    variable = DVarP("[FieldName]", "TableName", "[Criteria] = '" & Forms!FormName!ControlName & "'")

    ' Dates
    variable = DVarP("[FieldName]", "TableName", "[Criteria] = #" & Forms!FormName!ControlName & "#")
    ' ***************************

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DVarP("[FieldName]", "TableName", "[Criteria1] = " & Forms![FormName]![Control1] _
             & " AND [Criteria2] = '" & Forms![FormName]![Control2] & "'" _
            & " AND [Criteria3] =#" & Forms![FormName]![Control3] & "#")
    
    ' Use two fields from a single record.
    variable = DVarP("[LastName] & ', ' & [FirstName]", "tblPeople", "[PrimaryKey] = 7")
            
    ' Expressions
    variable = DVarP("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")
    
    ' Control Structures
    variable = DVarP("IIf([LastName] Like 'Smith', 'True', 'False')", "tableName", "[PrimaryKey] = 7")
    ' ***************************

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.