Compartir a través de


CDaoRecordset::FindFirst

Llame a esta función miembro para encontrar el primer registro que coincide con una condición especificada.

BOOL FindFirst(
   LPCTSTR lpszFilter 
);

Parámetros

  • lpszFilter
    Una expresión de cadena (como la cláusula de Dónde en una instrucción SQL sin la palabra Dónde) utilizada para buscar el registro.

Valor devuelto

Distinto de cero si coincide con los registros se encuentran, si no 0.

Comentarios

La función miembro de FindFirst inicia la búsqueda desde el comienzo del conjunto de registros y las búsquedas al final del conjunto de registros.

Si desea incluir todos los registros de búsqueda (no solo los que satisfacen una condición específica) utiliza una de las operaciones de mover para desplazarse de un registro a otro.Para buscar un registro en un conjunto de registros de tabla-tipo, llame a la función miembro de Seek .

Si la coincidencia de registro los criterios no se encuentra, el indicador de registro actual es indeterminado, y FindFirst devuelve cero.Si el conjunto de registros contiene más de un registro que cumpla los criterios, FindFirst encuentra la primera aparición, FindNext encuentra la siguiente aparición, etc.

Nota de precauciónPrecaución

Si edita el registro actual, asegúrese de guardar los cambios llamando a la función miembro de Update antes de mover a otro registro.Si mueve a otro registro sin actualizar, los cambios se pierden sin advertencia.

La búsqueda de las funciones miembro de Buscar location y en la dirección especificada en la tabla siguiente:

Operaciones de búsqueda

Principio

Dirección de búsqueda

FindFirst

Principio del conjunto de registros

Final del conjunto de registros

FindLast

Final del conjunto de registros

Principio del conjunto de registros

FindNext

Registro actual

Final del conjunto de registros

FindPrevious

Registro actual

Principio del conjunto de registros

[!NOTA]

Cuando se llama a FindLast, el motor de base de datos Microsoft Jet rellena totalmente el conjunto de registros antes de iniciar la búsqueda, si éste no ha sido ya ha.la primera búsqueda puede durar búsquedas que subsiguientes.

Utilizando uno de búsqueda operaciones no son lo mismo que llamando a MoveFirst o MoveNext, sin embargo, que crea simplemente la primera o siguiente actual de registro sin especificar una condición.Puede realizar una operación de búsqueda con una operación de movimiento.

Mantenga el siguiente en cuenta al utilizar las operaciones de búsqueda:

  • Si Buscar devuelve cero, el registro actual no está definido.En este caso, debe colocar el indicador de registro actual a un registro válido.

  • No puede utilizar una operación de búsqueda con un conjunto de registros sólo hacia delante de tipo instantánea de desplazamiento.

  • Debe utilizar el formato de fecha.. de EE.UU. (mes-día- año) al buscar los campos que contienen las fechas, incluso si no está utilizando la versión.. de EE.UU. el motor de bases de datos Microsoft Jet; si no, los registros que coinciden no pueden encontrarse.

  • Al trabajar con bases de datos ODBC y los conjuntos grandes, puede detectar que mediante las operaciones de búsqueda es lento, sobre todo al trabajar con conjuntos de registros grandes.Puede mejorar el rendimiento utilizando consultas SQL con cláusulas personalizadas de OrdenarBY o de Dónde , las consultas de parámetros, o los objetos de CDaoQuerydef que recuperan los registros indizado concretos.

Para obtener información relacionada, vea el tema “FindFirst, FindLast, FindNext, métodos de FindPrevious” en la Ayuda de DAO.

Requisitos

encabezado: afxdao.h

Vea también

Referencia

Clase CDaoRecordset

Gráfico de jerarquía

CDaoRecordset::Find

CDaoRecordset::FindLast

CDaoRecordset::FindNext

CDaoRecordset::FindPrev