Acerca de esta tarea
La creación de una consulta implica
la creación de, como mínimo, tres objetos separados: un objeto QueryDef, un objeto QueryFilterNode y un objeto ResultSet.
Las consultas más complejas también pueden implicar la creación de objetos QueryFilterNode
adicionales.
Procedimiento
Para crear una consulta, siga los pasos que se indican a continuación:
- Cree un objeto QueryDef y rellénelo con los parámetros de
búsqueda.
Para crear este objeto, utilice el método BuildQuery
del objeto Session.
Nota: Utilice el método
BuildQuery
para compilar una consulta, y no el método
BuildSQLQuery.
El método
BuildSQLQuery
genera un objeto ResultSet directamente a partir de una serie de consulta SQL.
- Utilice los métodos de QueryDef para añadir criterios de búsqueda
y especificar los campos de cada registro que desea que devuelva la consulta.
- Cree un objeto ResultSet para mantener los datos devueltos.
Para crear este objeto, llame al método BuildResultSet del objeto Session. En el momento de la creación, el objeto ResultSet crea un conjunto de estructuras de datos internas mediante la información del objeto QueryDef como plantilla. Cuando se ejecuta la consulta, el objeto ResultSet rellena estas estructuras de datos con datos de la consulta.
- Ejecute la consulta llamando al método Execute del objeto ResultSet.
- Acceda a los datos utilizando otros métodos de este objeto.
(Para obtener más información, consulte el apartado "Navegación a través de un conjunto de resultados").
Resultados
Nota: Si utiliza el método BuildSQLQuery
para crear una consulta basada en la sintaxis SQL, la serie de la consulta debe contener todos los parámetros de búsqueda deseados. El método BuildSQLQuery devuelve directamente un objeto ResultSet, en lugar de devolver un objeto QueryDef.