CDaoRecordset::Seek

Buscar BOOL (LPCTSTR lpszComparison, COleVariant * pKey1, COleVariant * pKey2 = NULL, COleVariant * pKey3 = NULL);
Tiro (CDaoException, CMemoryException);

Buscar BOOL (LPCTSTR lpszComparison, COleVariant * pKeyArray, palabra nKeys);
tirar (CDaoException, CMemoryException);

Valor devuelto

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

Parámetros

lpszComparison

Una de las siguientes expresiones de cadena: "lt;", "< =", "=", "> =", o ">".

pKey1

Un puntero a un COleVariant cuyo valor corresponde al primer campo en el índice. Obligatorio.

pKey2

Un puntero a un COleVariant cuyo valor se corresponde con el segundo campo del índice, si alguna. El valor predeterminado es NULL.

pKey3

Un puntero a un COleVariant cuyo valor se corresponde con el tercer campo en el índice, si alguna. El valor predeterminado es NULL.

pKeyArray

Un puntero a una matriz de variantes. El tamaño de la matriz se corresponde con el número de campos en el índice.

nKeys

Un entero que corresponde al tamaño de la matriz, que es el número de campos en el índice.

&Notanbsp;  No especifique comodines en los cayos. Comodines causará Seek no devolver registros coincidentes.

Observaciones

Llame a esta función miembro para buscar el registro en un objeto recordset de tipo tabla indizada que satisface los criterios especificados para el actual índice y hacen grabar el registro actual. Utilice la segunda versión (matriz) de Seek para manejar índices de cuatro campos o más.

Seek permite índice alto rendimiento buscar conjuntos de registros de tipo tabla. Debe establecer el índice actual llamando SetCurrentIndex antes de llamar a Seek. Si el índice identifica un campo clave no único o campos, Seek localiza el primer registro que cumple los criterios. Si no se establece un índice, se produce una excepción.

Tenga en cuenta que si no se crea un conjunto de registros UNICODE, los objetos COleVariant deben declarar explícitamente ANSI. Esto puede hacerse mediante el formulario de vtSrc ) de lpszSrc, de COleVariant::COleVariant( ) del constructor con vtSrc establecido en VT_BSTRT (ANSI) o mediante la función COleVariant SetString( lpszSrc, vtSrc ) con vtSrc a VT_BSTRT.

Cuando llames Seek, pasar uno o más valores de claves y un operador de comparación ("lt;", "< =", "=", "> =", o ">"). Seek busca a través de los campos de claves especificados y localiza el primer registro que cumple los criterios especificados por lpszComparison y pKey1. Una vez encontrado, Seek devuelve cero y hace que el registro actual. Si falla Seek localizar a una coincidencia, Seek devuelve cero, y el registro actual está definido. Cuando se utiliza DAO directamente, debe comprobar explícitamente la propiedad NoMatch.

Si lpszComparison es "=", nbsp; "> =", o ">", Seek se inicia al principio del índice. Si lpszComparison es "<" o "< =" Seek se inicia al final del índice y búsquedas hacia atrás si no hay duplicación de entradas de índice al final. En este caso, Seek comienza con una entrada arbitraria entre las entradas de índice duplicado al final del índice.

Allí no tiene que ser un registro actual al utilizar Seek.

Para localizar un registro en un recordset de tipo instantánea que satisface una condición específica o un tipo dynaset, utilizar las operaciones de búsqueda. Para incluir todos los registros, no sólo aquellos que satisfacen una condición específica, utilice las operaciones de movimiento para desplazarse de un registro a otro.

No se puede llamar búsqueda en una tabla adjunta de cualquier tipo porque tablas adjuntas deben abrirse como tipo dynaset o conjuntos de registros de tipo instantánea. Sin embargo, si llama a CDaoDatabase::Open para abrir directamente una base de datos ISAM instalable, puede llamar Seek en las tablas de la base de datos, aunque el rendimiento puede ser lento.

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 "Método buscar" en la ayuda de DAO.

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

Vea tambiénnbsp;CDaoRecordset::FindFirst, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev, CDaoRecordset::Move, CDaoRecordset::MoveFirst, CDaoRecordset::MoveLast, CDaoRecordset::MoveNext, CDaoRecordset::MovePrev, COleVariant::COleVariant, COleVariant::SetString

Index