Instanciation d'événements ADO : ADO et WFC

ADO pour les classes Windows Foundation (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 ce code :

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

2. Définissez un objet de gestionnaire pour représenter votre gestionnaire d’événements. L’objet gestionnaire doit être de type de données ConnectEventHandler pour un événement de type ConnectionEvent, ou de 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 qui contient 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 connexion ou une opération d'Recordset est intercepté par un gestionnaire d’événements ADO/WFC.

   Le gestionnaire d’événements ADO/WFC transmet les paramètres ADO ConnectionEvent dans une instance de la classe ADO/WFC ConnectionEvent ou ADO RecordsetEvent paramètres 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 onConnectComplete gestionnaire a une signature semblable à ceci :

   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 argument est l’objet d’événement ADO/WFC (ConnectionEvent ou RecordsetEvent).

   La signature de votre gestionnaire d’événements est plus simple qu’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. Revenez de votre gestionnaire d’événements au gestionnaire ADO/WFC pour l’événement ADO. ADO/WFC copie les membres de données d’événements ADO/WFC pertinents dans les paramètres d’événement ADO, puis le gestionnaire d’événements ADO renvoie.

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

Voir aussi

Résumé du Gestionnaire d'Événements ADO
ADO - Index de syntaxe WFC
paramètres d’événement
comment les gestionnaires d’événements fonctionnent ensemble
types d’événements