Instanciation des événements ADO ADO et WFC

ADO pour Windows Foundation Classes (ADO/WFC) s’appuie sur le modèle d’événement ADO et présente une interface de programmation d’application simplifiée. En général, ADO/WFC intercepte les événements ADO, consolide les paramètres d’événement dans une classe d’événements unique, puis appelle votre gestionnaire d’événements.

Pour utiliser des événements ADO dans ADO/WFC

1. Définissez votre propre gestionnaire d’événements pour traiter un événement. Par exemple, si vous souhaitez traiter l’événement ConnectComplete dans la famille ConnectionEvent, vous pouvez utiliser le code suivant :

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

2. Définissez un objet gestionnaire pour représenter votre gestionnaire d’événements. L’objet gestionnaire doit être du type de données ConnectEventHandler pour un événement de type ConnectionEvent, ou du type de données RecordsetEventHandler pour un événement de type RecordsetEvent. Par exemple, codez ce qui suit pour votre gestionnaire d’événements ConnectComplete :

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

   Le premier argument du constructeur ConnectionEventHandler est une référence à la classe contenant le gestionnaire d’événements nommé dans le deuxième argument.

3. Ajoutez votre gestionnaire d’événements à une liste de gestionnaires désignés pour traiter un type particulier d’événement. Utilisez la méthode avec un nom tel que addOnEventName(gestionnaire).

4. ADO/WFC implémente en interne tous les gestionnaires d’événements ADO. Par conséquent, un événement provoqué par une opération d’objet Connection ou Recordset est intercepté par un gestionnaire d’événements ADO/WFC.

   Le gestionnaire d’événements ADO/WFC transmet des paramètres ADO ConnectionEvent dans une instance de la classe ADO/WFC ConnectionEvent, ou des paramètres ADO RecordsetEvent dans une instance de la classe ADO/WFC RecordsetEvent. Ces classes ADO/WFC consolident les paramètres d’événement ADO. Autrement dit, chaque classe ADO/WFC contient un membre de données pour chaque paramètre unique dans toutes les méthodes ADO ConnectionEvent ou RecordsetEvent.

5. ADO/WFC appelle ensuite votre gestionnaire d’événements avec l’objet d’événement ADO/WFC. Par exemple, votre gestionnaire onConnectComplete a une signature semblable à la suivante :

   public void onConnectComplete(Object sender,ConnectionEvent e)  
   

   Le premier argument est le type d’objet qui a envoyé l’événement (Connection ou Recordset), et le deuxième est l’objet d’événement ADO/WFC (ConnectionEvent ou RecordsetEvent).

   La signature de votre gestionnaire d’événements est plus simple que celle d’un événement ADO. Toutefois, vous devez toujours comprendre le modèle d’événement ADO pour savoir quels paramètres s’appliquent à un événement et comment répondre.

6. Retournez à partir de votre gestionnaire d’événements au gestionnaire ADO/WFC pour l’événement ADO. ADO/WFC recopie les membres pertinents de données d’événement ADO/WFC dans les paramètres d’événement ADO, puis le gestionnaire d’événements ADO retourne.

7. Lorsque vous avez terminé le traitement, supprimez votre gestionnaire de la liste des gestionnaires d’événements ADO/WFC. Utilisez la méthode avec un nom tel que removeOnEventName(gestionnaire).

Voir aussi

Présentation rapide du gestionnaire d’événements ADO
ADO - Index de la syntaxe WFC
Paramètres des événements
Fonctionnement conjoint des gestionnaires d’événements
Types d’événements