CDaoRecordset::FindFirst

BOOL FindFirst (LPCTSTR lpszFilter);
Tiro (CDaoException, CMemoryException);

Valor devuelto

Distinto de cero si se encuentran registros coincidentes, caso contrario 0.

Parámetros

lpszFilter

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

Observaciones

Llame a esta función miembro para buscar el primer registro que coincida con una condición especificada. La función de miembro de FindFirst comienza su búsqueda desde el principio del juego de registros y busca al final del juego de registros.

Si desea incluir todos los registros de la búsqueda (no sólo aquellos que cumplen una condición específica) utilizan una de las operaciones de movimiento para desplazarse de un registro a otro. Para localizar un registro en un recordset de tipo tabla, llame a la función de miembro de Seek.

Si no encuentra un registro que coincida con el criterio, el puntero del registro actual es indeterminado y FindFirst devuelve cero. Si el juego de registros contiene más de un registro que cumple los criterios, que FindFirst localiza la primera aparición, FindNext localiza la siguiente aparición etc.

Precaució&nnbsp;  Si edita el registro actual, asegúrese de guardar los cambios mediante una llamada a la función de miembro de actualización antes de desplazarse a otro registro. Si se mueve a otro registro sin actualizar, los cambios se pierden sin previo aviso.

Las funciones de miembro encontrar buscar desde la ubicación y en la dirección especificada en la tabla siguiente:

Importa&ntenbsp;  Cuando se llama FindLast, el motor de base de datos de Microsoft Jet llena plenamente registros antes de comenzar la búsqueda, si esto no se ha hecho. La primera búsqueda puede tardar más de búsquedas posteriores.

Utilizando una de las operaciones de búsqueda no es lo mismo que llamar MoveFirst o MoveNext, sin embargo, que simplemente hace el primer o el siguiente registro actual sin especificar una condición. Puede seguir una operación de búsqueda con una operación de movimiento.

Tenga en cuenta lo siguiente cuando se utilizan las operaciones de búsqueda:

• Si encontrar devuelve cero, el registro actual no está definido. En este caso, deberá situar el puntero del registro actual a un registro válido.
  
  
• No puede utilizar una operación de búsqueda con un recordset de tipo snapshot desplazamiento sólo hacia delante.
  
  
• Debe utilizar el formato de fecha de Estados Unidos (mes-día-año) cuando se busca campos que contienen fechas, incluso si no está utilizando la versión estadounidense del motor de base de datos de Microsoft Jet; de lo contrario, registros coincidentes no se encuentre.
  
  
• Cuando se trabaja con bases de datos ODBC y grandes conjuntos de registros dinámicos, puede descubrir que mediante las operaciones de búsqueda es lento, especialmente al trabajar con grandes conjuntos de registros. Puede mejorar el rendimiento mediante consultas personalizadas cláusulas ORDER BY o donde SQL, consultas de parámetros o CDaoQuerydef objetos que recuperar determinados registros indexados.

Para obtener más información sobre cómo buscar registros, vea el artículo conjunto de registros DAO: conjunto de registros de navegación en la Guía del programador de Visual C++. Para obtener información relacionada, vea el tema "FindFirst, FindLast, FindNext, FindPrevious métodos" en la ayuda de DAO.

Visió&n General de CDaoRecordset |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDaoRecordset::Find, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev