Condividi tramite


Istanziazione di eventi ADO: ADO e WFC

ADO for Windows Foundation Classes (ADO/WFC) si basa sul modello di evento ADO e presenta un'interfaccia di programmazione dell'applicazione semplificata. In generale, ADO/WFC intercetta gli eventi ADO, consolida i parametri dell'evento in una singola classe di evento e quindi chiama il gestore eventi.

Per usare eventi ADO in ADO/WFC

  1. Definire un gestore eventi personalizzato per elaborare un evento. Ad esempio, se si vuole elaborare l'evento ConnectComplete nella famiglia di eventi ConnectionEvent, è possibile usare questo codice:

    public void onConnectComplete(Object sender,ConnectionEvent e)  
    {  
        System.out.println("onConnectComplete:" + e);  
    }  
    
  2. Definire un oggetto gestore per rappresentare il gestore degli eventi. L'oggetto gestore deve essere di tipo dati ConnectEventHandler per un evento di tipo ConnectionEvento tipo di dati RecordsetEventHandler per un evento di tipo RecordsetEvent. Ad esempio, scrivere il codice seguente per il gestore eventi ConnectComplete:

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

    Il primo argomento del costruttore ConnectionEventHandler è un riferimento alla classe contenente il gestore eventi denominato nel secondo argomento.

  3. Aggiungere il gestore eventi a un elenco di gestori designati per elaborare un determinato tipo di evento. Usare il metodo con un nome, ad esempio addOnEventName(gestore).

  4. ADO/WFC implementa internamente tutti i gestori eventi ADO. Pertanto, un evento causato da un'operazione di Connection o Recordset viene intercettata da un gestore eventi ADO/WFC.

    Il gestore eventi ADO/WFC passa i parametri ConnectionEvent ADO in un'istanza della classe ADO/WFC ConnectionEvent, oppure i parametri RecordsetEvent ADO in un'istanza della classe ADO/WFC RecordsetEvent. Queste classi ADO/WFC consolidano i parametri degli eventi ADO; ovvero, ogni classe ADO/WFC contiene un membro di dati per ogni parametro univoco presente in tutti i metodi ADO ConnectionEvent o RecordsetEvent.

  5. ADO/WFC chiama quindi il gestore eventi con l'oggetto evento ADO/WFC. Ad esempio, il gestore onConnectComplete ha una firma simile a questa:

    public void onConnectComplete(Object sender,ConnectionEvent e)  
    

    Il primo argomento è il tipo di oggetto che ha inviato l'evento (Connection o Recordset) e il secondo argomento è l'oggetto evento ADO/WFC (ConnectionEvent o RecordsetEvent).

    La firma del gestore eventi è più semplice di un evento ADO. Tuttavia, è comunque necessario comprendere il modello di evento ADO per sapere quali parametri si applicano a un evento e come rispondere.

  6. Torna dal gestore del tuo evento al gestore ADO/WFC per l'evento ADO. ADO/WFC copia i membri dei dati dell'evento ADO/WFC pertinenti nei parametri dell'evento ADO e quindi il gestore eventi ADO restituisce.

  7. Al termine dell'elaborazione, rimuovere il gestore dall'elenco dei gestori eventi ADO/WFC. Usare il metodo con un nome come removeOnEventName(gestore).

Vedere anche

Riepilogo del gestore eventi ADO
ADO - Indice della sintassi WFC
Parametri di Evento
Come funzionano i gestori di eventi
tipi di eventi