ADO WillConnect、ConnectCompleteおよびDisconnectイベント
定義と用法
イベントは特定の操作が発生した後に自動的に呼び出されるサブルーチンです。
- WillConnectイベントは接続が開始される前にトリガーされます。
- ConnectCompleteイベントは接続が開始された後にトリガーされます。
- 接続が終了した後にDisconnectイベントがトリガーされます。
文法
WillConnect ConnectionString,userid,psword,options,status,objcon ConnectComplete objerror,status,objconn Disconnectステータス,objconn
| パラメータ | 説明 |
|---|---|
| ConnectionString | 接続に使用する情報を含む文字列。 |
| userid | 接続に使用するユーザー名を含む文字列。 |
| psword | 接続に使用するパスワードを含む文字列。 |
| options | Long値で、ConnectionStringの計算方法を示します。唯一のオプションはadAsyncOpenです。 |
| objerror |
発生したエラーを含むErrorオブジェクト。 注釈：EventStatusEnum 値はadStatusErrorsOccurredに設定する必要があります。これによりErrorオブジェクトが作成されます。 |
| status |
一つ EventStatusEnum 値。デフォルトは adStatusOK です。 ConnectComplete が呼び出されたとき、WillConnect イベントが一時停止された接続をキャンセルを要求する場合、このパラメータは adStatusCancel に設定されます。 |
| objconn | このイベントに適用される Connection オブジェクト。 |
EventStatusEnum 値
| 定数 | 値 | 説明 |
|---|---|---|
| adStatusOK | 1 | このイベントを引き起こした操作が成功しました。 |
| adStatusErrorsOccurred | 2 | このイベントを引き起こした操作が失敗しました。 |
| adStatusCantDeny | 3 | 一時停止された操作をキャンセルすることはできません。 |
| adStatusCancel | 4 | イベントを引き起こした操作をキャンセルします。 |
| adStatusUnwantedEvent | 5 | イベントメソッドの実行が終わる前に、さらなる通知を禁止します。 |
