CDaoRecordset::FindFirst

Artículo
06/10/2015

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.

Advertencia

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.