Partilhar via

Instanciação de Eventos ADO: ADO e WFC

  • Artigo

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

Para usar eventos do ADO no ADO/WFC

  1. Defina seu próprio manipulador de eventos para processar um evento. Por exemplo, se você quiser processar o evento ConnectComplete na família de eventos ConnectionEvent, poderá usar 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 do manipulador deve ser do tipo de dados ConnectEventHandler para um evento do tipo ConnectionEventou tipo de dados RecordsetEventHandler para um evento do tipo RecordsetEvent. Por exemplo, escreva o seguinte código para o manipulador de eventos ConnectComplete do :

    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 determinado tipo de evento. Use o método com um nome como addOnEventName(manipulador).

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

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

  5. Em seguida, o ADO/WFC chama seu manipulador de eventos usando o objeto de evento ADO/WFC. Por exemplo, o manipulador de 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 do ADO. No entanto, você ainda deve entender o modelo de evento do ADO para saber quais parâmetros se aplicam a um evento e como responder.

  6. Retorne do manipulador de eventos para o manipulador ADO/WFC para o evento ADO. O ADO/WFC copia de volta para os parâmetros de evento do ADO os membros de dados relevantes. Em seguida, o manipulador de eventos do ADO retorna.

  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(manipulador).

Consulte Também

resumo do manipulador de eventos do ADO
ADO – índice de sintaxe WFC
parâmetros de evento
como os manipuladores de eventos funcionam juntos
tipos de eventos