Table of contents
TOC
Recolher sumário
Expandir sumário

Método Application.DVar (Access)Application.DVar Method (Access)

office 365 dev account|Última Atualização: 03/04/2018
|
2 Colaboradores

Estima a variação de um exemplo em um conjunto de registros especificado (um domínio).Estimates the variance across a sample in a specified set of records (a domain).

SintaxeSyntax

expression.expression.DVar (* * Expr, * * domínio, * * critérios* )DVar( ** Expr, ** Domain, ** Criteria* )

expressão Uma variável que representa um objeto Application.expression A variable that represents an Application object.

ParâmetrosParameters

NameNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
ExprExprObrigatórioRequiredStringStringUma expressão que identifica o campo numérico no qual você deseja encontrar a variância.An expression that identifies the numeric field on which you want to find the variance.Pode ser uma expressão de cadeia de caracteres que identifica um campo de uma tabela ou consulta ou pode ser uma expressão que executa um cálculo nos dados desse campo .It can be a string expression identifying a field from a table or query, or it can be an expression that performs a calculation on data in that field .Em expr, você pode incluir o campo nome em uma tabela, um controle em um formulário, uma constante ou uma função.In expr, you can include the name field in a table, a control on a form, a constant, or a function.Se expr inclui uma função, ela poderá ser interno ou definida pelo usuário, mas não outro domínio agregado ou função de agregação de SQL.If expr includes a function, it can be either built-in or user-defined, but not another domain aggregate or SQL aggregate function.Qualquer campo incluído em expr deve ser um campo numérico.Any field included in expr must be a numeric field.
DomainDomainObrigatórioRequiredStringStringUma 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 uma consulta que não exija um parâmetro.A string expression identifying the set of records that constitutes the domain. It can be a table name or a query name for a query that does not require a parameter.
CriteriaCriteriaOpcionalOptionalVariantVariantUma expressão de cadeia de caracteres opcional usada para restringir o intervalo de dados no qual a função DVar é executada.An optional string expression used to restrict the range of data on which the DVar function is performed.Por exemplo, critérios costuma ser equivalente à cláusula WHERE em uma expressão SQL, sem a palavra onde.For example, criteria is often equivalent to the WHERE clause in an SQL expression, without the word WHERE.Se os critérios for omitido, a função DVar avalia expr em relação ao domínio inteiro.If criteria is omitted, the DVar function evaluates expr against the entire domain.Qualquer campo que está incluído nos critérios também deve ser um campo de domínio; Caso contrário, a função DVar retornará Null.Any field that is included in criteria must also be a field in domain; otherwise the DVar function returns a Null.

Valor retornadoReturn Value

VariantVariant

ComentáriosRemarks

Por exemplo, você poderia usar a função DVar para calcular a variância em um conjunto de resultados de teste de alunos.For example, you could use the DVar function to calculate the variance across a set of students' test scores.

Se o domínio se refere a menos de dois registros ou se menos de dois registros satisfizerem criteria, a função DVar retornará Null, indicando que uma variância não pode ser calculada.If domain refers to fewer than two records or if fewer than two records satisfy criteria, the DVar functions return a Null, indicating that a variance can't be calculated.

Se você usar a função DVar em uma macro, módulo, expressão de consulta ou controle calculado, você deve construir o argumento criteria cuidadosamente para garantir que ele seja avaliado corretamente.Whether you use the DVar function in a macro, module, query expression, or calculated control, you must construct the criteria argument carefully to ensure that it will be evaluated correctly.

Você pode usar a função DVar para especificar os critérios na linha critério de uma consulta seleção, em uma expressão de campo calculado em uma consulta ou na linha Atualizar para de uma consulta atualização.You can use the DVar function to specify criteria in the Criteria row of a select query, in a calculated field expression in a query, or in the Update To row of an update query.

Observação Você pode usar a função DVar ou a função Var em uma expressão de campo calculado em uma consulta de totais.Note You can use the DVar function or the Var function in a calculated field expression in a totals query.Se você usar a função DVar , os valores são calculados antes de dados são agrupados.If you use the DVar function, values are calculated before data is grouped.Se você usar a função Var , os dados serão agrupados antes dos valores na expressão do campo são avaliados.If you use the Var function, the data is grouped before values in the field expression are evaluated.

Use a função DVar em um controle calculado quando você precisar especificar critérios para restringir o intervalo de dados no qual a função é executada.Use the DVar function in a calculated control when you need to specify criteria to restrict the range of data on which the function is performed.Por exemplo, para exibir uma variância de pedidos a serem enviados para a Califórnia, defina a propriedade ControlSource de uma caixa de texto com a expressão a seguir:For example, to display a variance for orders to be shipped to California, set the ControlSource property of a text box to the following expression:

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

Se você deseja simplesmente encontrar o desvio padrão de todos os registros em domínio, use a função Var ou VarP .If you simply want to find the standard deviation across all records in domain, use the Var or VarP function.

ExemploExample

O exemplo a seguir retorna estimativas de variância de uma população e uma amostra da população para os pedidos enviados ao Reino Unido.The following example returns estimates of the variance for a population and a population sample for orders shipped to the United Kingdom.O domínio é uma tabela Pedidos.The domain is an Orders table.O argumento criteria restringe o conjunto de registros resultante para os quais PaísDeDestino é igual a Reino Unido.The criteria argument restricts the resulting set of records to those for which ShipCountry equals 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'")

O próximo exemplo retorna estimativas utilizando uma variável, strCountry, no argumento criteria .The next example returns estimates by using a variable, strCountry, in the criteria argument.Observe que as aspas simples (') são incluídas na expressão de cadeia de caracteres, para que quando as cadeias de caracteres forem concatenadas, a cadeia de caracteres literal UK será incluído em aspas simples.Note that single quotation marks (') are included in the string expression, so that when the strings are concatenated, the string literal UK will be enclosed in single quotation marks.

Dim strCountry As String| 
Dim dblX As Double 

strCountry = "UK" 

dblX = DVar("[Freight]", "Orders", "[ShipCountry] = '" _ 
    &; strCountry &; "'")

Os exemplos a seguir mostram como usar vários tipos de critérios com a função DVar .The following examples show how to use various types of criteria with the DVar function.

Código de exemplo fornecido pela:ícone do membro da comunidade comunidade UtterAccessSample code provided by:Community Member Icon TheUtterAccess community

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

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

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

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

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

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

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DVar("[FieldName]", "TableName", "[Criteria1] = " &; Forms![FormName]![Control1] _
             &; " AND [Criteria2] = '" &; Forms![FormName]![Control2] &; "'" _
            &; " AND [Criteria3] =#" &; Forms![FormName]![Control3] &; "#")

    ' Use two fields from a single record.
    variable = DVar("[LastName] &; ', ' &; [FirstName]", "tblPeople", "[PrimaryKey] = 7")

    ' Expressions
    variable = DVar("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")

    ' Control Structures
    variable = DVar("IIf([LastName] Like 'Smith', 'True', 'False')", "tableName", "[PrimaryKey] = 7")
    ' ***************************

Sobre os colaboradoresAbout the Contributors

UtterAccess é o fórum principal de wiki e a Ajuda do Microsoft Access. clique aqui para ingressar.UtterAccess is the premier Microsoft Access wiki and help forum. Click here to join.

Confira tambémSee also

ConceitosConcepts

Objeto ApplicationApplication Object

© 2018 Microsoft