Puede utilizar un objeto ResultSet para ejecutar una consulta y examinar los resultados de la consulta.
Cuando crea consultas por medio del objeto QueryDef, debe crear un objeto ResultSet correspondiente para ejecutar la consulta y obtener los resultados. Cada objeto ResultSet se personaliza para la consulta que se ejecuta. El objeto ResultSet contiene estructuras de datos que organizan los datos de la consulta en filas y columnas, donde cada fila representa un único registro de datos y cada columna representa un campo del registro de datos. Después de ejecutar la consulta, puede navegar (moverse) fila a fila y columna a columna, para obtener los datos que desea.
Tenga en cuenta que:
- Las columnas están numeradas de (1 a N), no de (0 a N-1).
- Una vez que se haya generado el conjunto de resultados, es posible que necesite rellenar valores de parámetro, si se trata de una consulta con parámetros.
- Una vez que se haya generado el conjunto de resultados y se hayan establecido los parámetros (si procede), la puede ejecutar para ver la salida de la consulta.
Se permite ejecutar el conjunto de resultados varias veces, si se desea volver a ejecutar la consulta. (Es posible que haya borrado y restablecido los valores de parámetro). También se permite obtener el SQL para la consulta.
- Conceptualmente, una consulta puede generar tanta salida que puede resultar imposible o, incluso, inútil copiarla sólo de la base de datos en la memoria del programa. Por ello, se debe utilizar un "cursor" para navegar a través de la salida, utilizando el método MoveNext.
- Inmediatamente después de ejecutar el conjunto de resultados, el cursor se sitúa "justo antes" del primer elemento, de modo que se debe llamar a MoveNext para poder extraer el primer valor.
- Para obtener el valor una vez que se haya colocado en la posición adecuada, utilice el método
GetColumnValue.
Para ver un ejemplo de cómo utilizar
el objeto ResultSet, consulte Ejecución de una consulta que tiene filtros dinámicos.