ADO-Ereignisinstanziierung: ADO und WFC

ADO für Windows Foundation Classes (ADO/WFC) baut auf dem ADO-Ereignismodell auf und stellt eine vereinfachte Anwendungsprogrammierschnittstelle dar. Im Allgemeinen fängt ADO/WFC ADO-Ereignisse ab, konsolidiert die Ereignisparameter in einer einzelnen Ereignisklasse und ruft dann den Ereignishandler auf.

So verwenden Sie ADO-Ereignisse in ADO/WFC

1. Definieren Sie ihren eigenen Ereignishandler zum Verarbeiten eines Ereignisses. Wenn Sie beispielsweise das ConnectComplete--Ereignis in der ConnectionEvent- familie verarbeiten möchten, können Sie diesen Code verwenden:

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

2. Definieren Sie ein Handlerobjekt, das den Ereignishandler darstellt. Das Handlerobjekt sollte vom Datentyp ConnectEventHandler für ein Ereignis vom Typ ConnectionEvent-sein, oder datentyp RecordsetEventHandler für ein Ereignis vom Typ RecordsetEvent. Codieren Sie beispielsweise Folgendes für den ConnectComplete Ereignishandler:

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

   Das erste Argument des ConnectionEventHandler-Konstruktors ist ein Verweis auf die Klasse, die den im zweiten Argument benannten Ereignishandler enthält.

3. Fügen Sie den Ereignishandler einer Liste von Handlern hinzu, die für die Verarbeitung eines bestimmten Ereignistyps festgelegt sind. Verwenden Sie die Methode mit einem Namen wie addOnEventName(Handler).

4. ADO/WFC implementiert intern alle ADO-Ereignishandler. Daher wird ein Ereignis, das durch eine Connection oder Recordset Operationen verursacht wird, von einem ADO/WFC-Ereignishandler abgefangen.

   Der ADO/WFC-Ereignishandler übergibt ADO ConnectionEvent Parameter in einer Instanz der ADO/WFC ConnectionEvent-Klasse oder ADO RecordsetEvent Parameter in einer Instanz der ADO/WFC RecordsetEvent-Klasse. Diese ADO/WFC-Klassen konsolidieren die ADO-Ereignisparameter; d. h. jede ADO/WFC-Klasse enthält ein Datenelement für jeden eindeutigen Parameter in allen ADO-ConnectionEvent-- oder RecordsetEvent--Methoden.

5. ADO/WFC ruft dann den Ereignishandler mit dem ADO/WFC-Ereignisobjekt auf. Ihr onConnectComplete--Handler verfügt beispielsweise über eine Signatur wie folgt:

   public void onConnectComplete(Object sender,ConnectionEvent e)  
   

   Das erste Argument ist der Typ des Objekts, das das Ereignis gesendet hat (Connection oder Recordset), und das zweite Argument ist das Ereignisobjekt ADO/WFC (ConnectionEvent oder RecordsetEvent).

   Die Signatur des Ereignishandlers ist einfacher als ein ADO-Ereignis. Sie müssen jedoch das ADO-Ereignismodell immer noch verstehen, um zu wissen, welche Parameter auf ein Ereignis angewendet werden und wie sie reagieren.

6. Kehren Sie aus Ihrem Ereignishandler zum ADO/WFC-Handler für das ADO-Ereignis zurück. ADO/WFC kopiert die relevanten ADO/WFC-Ereignisdatenmitglieder zurück in die ADO-Ereignisparameter, woraufhin der ADO-Ereignishandler zurückkehrt.

7. Wenn Sie die Verarbeitung abgeschlossen haben, entfernen Sie den Handler aus der Liste der ADO/WFC-Ereignishandler. Verwenden Sie die Methode mit einem Namen wie removeOnEventName(Handler).

Siehe auch

ADO-Ereignishandler-Übersicht
ADO - WFC-Syntax-Index
Ereignisparameter
Zusammenarbeit von Ereignishandlern
Ereignistypen