Método Application.DFirst (Access)

Use la función DFirst para devolver un registro aleatorio de un campo determinado de una tabla o consulta cuando necesite cualquier valor de ese campo.

Sintaxis

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

expresión Variable que representa un objeto Application.

Parámetros

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Expr	Obligatorio	String	Una expresión que identifica el campo en el que quiere buscar el primer o último valor. Puede ser una expresión de cadena que identifica un campo de una tabla o consulta, o 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 integrada o definida por el usuario, pero no otra función de agregado de dominio o de agregado de SQL.
Dominio	Obligatorio	String	Una expresión de cadena que identifica el conjunto de registros que constituyen el dominio.
Criteria	Opcional	Variant	Expresión de cadena opcional que se utiliza para restringir el intervalo de datos con el que se ejecuta la función DFirst. Por ejemplo, el argumento 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 DFirst evalúa expr para todo el dominio. Cualquier campo que se incluya en criteria debe ser también un campo de domain; de lo contrario, la función DFirst devuelve un valor Null.

Valor devuelto

Variant

Comentarios

Nota:

Si quiere que se devuelva el primer o último registro de un conjunto de registros (un dominio), deberá crear una consulta ordenada de manera ascendente o descendente y establecer la propiedad TopValues en 1. En Visual Basic, también puede crear un objeto Recordset de ADO y usar el método MoveFirst o MoveLast para que se devuelva el primer o último registro de un conjunto de registros.

Ejemplo:

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

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

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

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

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

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

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

    ' ***************************
    ' Combinations
    ' Multiple types of criteria
    variable = DFirst("[FieldName]", "TableName", "[Criteria1] = " & Forms![FormName]![Control1] _
             & " AND [Criteria2] = '" & Forms![FormName]![Control2] & "'" _
            & " AND [Criteria3] =#" & Forms![FormName]![Control3] & "#")
    
    ' Use two fields from a single record.
    variable = DFirst("[LastName] & ', ' & [FirstName]", "tblPeople", "[PrimaryKey] = 7")
            
    ' Expressions
    variable = DFirst("[Field1] + [Field2]", "tableName", "[PrimaryKey] = 7")
    
    ' Control Structures
    variable = DFirst("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.