ADO イベントのインスタンス化: ADO と WFC

[アーティクル]
02/15/2017

ADO for Windows Foundation Classes (ADO/WFC) は、ADO イベントモデルに基づいて構築され、簡略化されたアプリケーションプログラミングインターフェイスを提供します。一般に、ADO/WFC は ADO イベントをインターセプトし、イベントパラメーターを 1 つのイベントクラスに統合してから、イベントハンドラーを呼び出します。

ADO/WFC で ADO イベントを使用するには

イベントを処理する独自のイベントハンドラーを定義します。たとえば、ConnectionEvent ファミリで ConnectComplete イベントを処理する場合は、次のコードを使用できます。
```
public void onConnectComplete(Object sender,ConnectionEvent e)  
{  
    System.out.println("onConnectComplete:" + e);  
}  
```
イベントハンドラーを表すハンドラーオブジェクトを定義します。ハンドラーオブジェクトは、ConnectEventHandler ConnectionEvent型のイベントのデータ型、または RecordsetEvent 型のイベント RecordsetEventHandlerデータ型である必要があります。たとえば、ConnectComplete イベントハンドラーのコードを次に示します。
```
ConnectionEventHandler handler =   
    new ConnectionEventHandler(this, "onConnectComplete");  
```
ConnectionEventHandler コンストラクターの最初の引数は、2 番目の引数で指定されたイベントハンドラーを含むクラスへの参照です。
特定の種類のイベントを処理するために指定されたハンドラーの一覧にイベントハンドラーを追加します。 addOnEventName(ハンドラー) などの名前でメソッドを使用します。
ADO/WFC は、すべての ADO イベントハンドラーを内部的に実装します。そのため、接続または Recordset 操作によって発生するイベントは、ADO/WFC イベントハンドラーによってインターセプトされます。

ADO/WFC イベントハンドラーは、ADO/WFC ConnectionEvent クラスのインスタンス内の ADO ConnectionEvent パラメーター、または ADO/WFC RecordsetEvent クラスのインスタンス内の ADO RecordsetEvent パラメーターを渡します。これらの ADO/WFC クラスは、ADO イベントパラメーターを統合します。つまり、各 ADO/WFC クラスには、すべての ADO ConnectionEvent または RecordsetEvent メソッド内の一意のパラメーターごとに 1 つのデータメンバーが含まれます。
その後、ADO/WFC は、ADO/WFC イベントオブジェクトを使用してイベントハンドラーを呼び出します。たとえば、onConnectComplete ハンドラーには、次のようなシグネチャがあります。
```
public void onConnectComplete(Object sender,ConnectionEvent e)  
```
最初の引数は、イベントを送信したオブジェクトの型です (Connection または Recordset)、2 番目の引数は ADO/WFC イベントオブジェクト (connectionEventまたは RecordsetEvent)。

イベントハンドラーのシグネチャは、ADO イベントよりも簡単です。ただし、イベントに適用されるパラメーターと応答方法を把握するには、ADO イベントモデルを理解する必要があります。
イベントハンドラーから ADO イベントの ADO/WFC ハンドラーに戻ります。 ADO/WFC は、関連する ADO/WFC イベントデータメンバーを ADO イベントパラメーターにコピーし、ADO イベントハンドラーが返します。
処理が完了したら、ADO/WFC イベントハンドラーの一覧からハンドラーを削除します。 removeOnEventName(ハンドラー) などの名前でメソッドを使用します。

次の方法で共有

ADO イベントのインスタンス化: ADO と WFC

ADO/WFC で ADO イベントを使用するには

関連項目

その他のリソース