Creación de instancias de eventos de ADO: ADO y WFC

ADO para Windows Foundation Classes (ADO/WFC) se basa en el modelo de eventos de ADO y presenta una interfaz de programación de aplicaciones simplificada. En general, ADO/WFC intercepta eventos de ADO, consolida los parámetros de evento en una sola clase de eventos y, a continuación, llama al controlador de eventos.

Para usar eventos de ADO en ADO/WFC

1. Defina su propio controlador de eventos para procesar un evento. Por ejemplo, si desea procesar el evento ConnectComplete en la familia ConnectionEvent, puede usar este código:

   public void onConnectComplete(Object sender,ConnectionEvent e)  
   {  
       System.out.println("onConnectComplete:" + e);  
   }  
   

2. Defina un objeto de controlador para representar el controlador de eventos. El objeto de controlador debe ser del tipo de datos ConnectEventHandler para un evento de tipo ConnectionEvent o de tipo de datos RecordsetEventHandler para un evento de tipo RecordsetEvent. Por ejemplo, codifique lo siguiente para el controlador de eventos ConnectComplete:

   ConnectionEventHandler handler =   
       new ConnectionEventHandler(this, "onConnectComplete");  
   

   El primer argumento del constructor ConnectionEventHandler es una referencia a la clase que contiene el controlador de eventos con nombre del segundo argumento.

3. Agregue el controlador de eventos a una lista de controladores designados para procesar un tipo determinado de evento. Use el método con un nombre como addOnEventName(controlador).

4. ADO/WFC implementa internamente todos los controladores de eventos de ADO. Por lo tanto, un controlador de eventos ADO/WFC intercepta un evento generado por una operación Connection o Recordset.

   El controlador de eventos ADO/WFC pasa parámetros ConnectionEvent de ADO en una instancia de la clase ConnectionEvent de ADO/WFC o los parámetros RecordsetEvent de ADO en una instancia de la clase RecordsetEvent de ADO/WFC. Estas clases ADO/WFC consolidan los parámetros de evento de ADO; es decir, cada clase ADO/WFC contiene un miembro de datos para cada parámetro único en todos los métodos ConnectionEvent o RecordsetEvent de ADO.

5. Después, ADO/WFC llama al controlador de eventos con el objeto de evento ADO/WFC. Por ejemplo, el controlador onConnectComplete tiene una firma similar a la siguiente:

   public void onConnectComplete(Object sender,ConnectionEvent e)  
   

   El primer argumento es el tipo de objeto que envió el evento (Connection o Recordset) y el segundo argumento es el objeto de evento ADO/WFC (ConnectionEvent o RecordsetEvent).

   La firma del controlador de eventos es más sencilla que un evento de ADO. Sin embargo, todavía debe comprender el modelo de eventos de ADO para saber qué parámetros se aplican a un evento y cómo responder.

6. Vuelva del controlador de eventos al controlador de ADO/WFC para el evento de ADO. ADO/WFC copia los miembros de datos de eventos de ADO/WFC pertinentes en los parámetros de evento de ADO y, a continuación, el controlador de eventos de ADO vuelve.

7. Una vez finalizado el procesamiento, quite el controlador de la lista de controladores de eventos ADO/WFC. Use el método con un nombre como removeOnEventName(controlador).

Consulte también

Conexión ADO y los eventos de conjunto de registros
ADO - índice de sintaxis WFC
Parámetros de eventos
Cómo funcionan conjuntamente los controladores de eventos
Tipos de eventos