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 de 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 ConnectionEvento 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 denominado en el 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 causado por una operación de conexión o de conjunto de registros.

   El controlador de eventos ADO/WFC pasa parámetros de conexión ADO ConnectionEvent en una instancia de la clase ADO/WFC ConnectionEvent, o parámetros de conjunto de registros ADO RecordsetEvent en una instancia de la clase ADO/WFC RecordsetEvent. Estas clases de 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.

5. Luego, ADO/WFC llama a su controlador de eventos con el objeto de evento ADO/WFC. Por ejemplo, el controlador de onConnectComplete tiene una firma como esta:

   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, debe comprender el modelo de eventos de ADO para saber qué parámetros se aplican a un evento y cómo responder.

6. Devuelva el control desde su 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 devuelve.

7. Cuando haya terminado el procesamiento, quite su controlador de la lista de controladores de eventos de ADO/WFC. Use el método con un nombre como removeOnEventName(controlador).

Consulte también

Resumen del Controlador de Eventos de ADO
ADO: índice de sintaxis WFC
Parámetros de Evento
Cómo los controladores de eventos trabajan en conjunto
Tipos de eventos