Instanciação de evento ADO: ADO e WFC

O ADO para Classes do Windows Foundation (ADO/WFC) se baseia no modelo de evento ADO e apresenta uma interface de programação de aplicativo simplificada. Em geral, o ADO/WFC intercepta eventos ADO, consolida os parâmetros de evento em uma só classe de evento e chama o manipulador de eventos.

Para usar os eventos do ADO no ADO/WFC

1. Defina seu manipulador de eventos para processar um evento. Por exemplo, caso deseje processar o evento ConnectComplete na família ConnectionEvent, use este código:

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

2. Defina um objeto de manipulador para representar o manipulador de eventos. O objeto de manipulador deve ser do tipo de dados ConnectEventHandler para um evento do tipo ConnectionEvent ou do tipo de dados RecordsetEventHandler para um evento do tipo RecordsetEvent. Por exemplo, codifique o seguinte para o manipulador de eventos ConnectComplete:

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

   O primeiro argumento do construtor ConnectionEventHandler é uma referência à classe que contém o manipulador de eventos nomeado no segundo argumento.

3. Adicione o manipulador de eventos a uma lista de manipuladores designados para processar um tipo específico de evento. Use o método com um nome como addOnEventName(handler).

4. O ADO/WFC implementa internamente todos os manipuladores de eventos ADO. Portanto, um evento causado por uma operação Connection ou Recordset é interceptado por um manipulador de eventos ADO/WFC.

   O manipulador de eventos ADO/WFC transmite os parâmetros ADO ConnectionEvent em uma instância da classe ADO/WFC ConnectionEvent ou os parâmetros ADO RecordsetEvent em uma instância da classe ADO/WFC RecordsetEvent. Essas classes ADO/WFC consolidam os parâmetros de eventos ADO, ou seja, cada classe ADO/WFC contém um membro de dados para cada parâmetro exclusivo em todos os métodos ADO ConnectionEvent ou RecordsetEvent.

5. Em seguida, o ADO/WFC chama o manipulador de eventos com o objeto de evento ADO/WFC. Por exemplo, o manipulador onConnectComplete tem uma assinatura como esta:

   public void onConnectComplete(Object sender,ConnectionEvent e)  
   

   O primeiro argumento é o tipo de objeto que enviou o evento (Connection ou Recordset) e o segundo argumento é o objeto de evento ADO/WFC (ConnectionEvent ou RecordsetEvent).

   A assinatura do manipulador de eventos é mais simples do que um evento ADO. No entanto, você ainda precisa entender o modelo de evento ADO para saber os parâmetros que se aplicam a um evento e como responder a eles.

6. Retorne um valor do manipulador de eventos para o manipulador ADO/WFC no evento ADO. O ADO/WFC copia os membros de dados de eventos ADO/WFC pertinentes novamente para os parâmetros de evento ADO e o manipulador de eventos ADO retorna os valores.

7. Quando terminar o processamento, remova o manipulador da lista de manipuladores de eventos ADO/WFC. Use o método com um nome como removeOnEventName(handler).

Consulte Também

Resumo do manipulador de eventos ADO
ADO – Índice de sintaxe WFC
Parâmetros de evento
Como os manipuladores de eventos funcionam em conjunto
Tipos de eventos