API:Data.Win.ADODB.TADOConnection.Connected
Delphi
property Connected;
C++
__property Connected = {default=0};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TADOConnection |
説明
データのリモート ソースに対して接続が確立されているか、それが有効であるかどうかを判別します。
Data.Win.ADODB.TADOConnection.Connected は Data.DB.TCustomConnection.Connected を継承しています。以下の内容はすべて Data.DB.TCustomConnection.Connected を参照しています。
データのリモート ソースに対して接続が確立されているか、それが有効であるかどうかを判別します。
Connected を True に設定すると、接続を開きます。 Connected を False に設定すると、接続を終了します。
Connected を True に設定することにより、BeforeConnect イベントの生成、protected DoConnect メソッドを呼び出すことによる接続の確立、そして、AfterConnect イベントの生成が行われます。 さらに、Connected を True に設定している際には、TCustomConnectionは、LoginPrompt の値に応じてログイン ダイアログを表示することができます。
Connected を False に設定することにより、BeforeDisconnect イベントの生成、protected DoConnect メソッドを呼び出すことによる接続の切断、そして、AfterDisconnect イベントの生成が行われます。
TCustomConnection から派生したカスタム接続コンポーネントの場合には、GetConnected をオーバーライドして接続確立時に True を返すと共に、DoConnect および DoDisconnect をオーバーライドして、接続の作成および切断を行うようにします。
ヒント： Bde.DBTables.TDatabase の場合、Connected を True に設定すると、データセットを開かずにデータベース接続を確立することができます。アプリケーションは、Connected をチェックすることにより、データベース接続の現在の状態を判断することができます。Connected が True の場合、データベース接続はアクティブであり、False でかつ、KeepConnection プロパティもまた False の場合には、接続は非アクティブということになります。 KeepConnection を True に設定すると、データベース接続が再オープンされるたびにサーバーへログインしなくてもよくなります。