Bde.DBTables.TDatabase.OnLogin
Delphi
property OnLogin: TDatabaseLoginEvent read FOnLogin write FOnLogin;
C++
__property TDatabaseLoginEvent OnLogin = {read=FOnLogin, write=FOnLogin};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
event | published | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TDatabase |
説明
アプリケーションがデータベースに接続したときに発生します。
OnLogin イベントハンドラを記述すると,アプリケーションがデータベースへ接続しようとしたときに特定の処理が行われるようにすることができます。LoginPrompt プロパティが true の場合には,データベースログインが必要です。
OnLogin イベントハンドラが存在しない場合には,現在の UserName が Params プロパティから読み出され,標準ログインダイアログボックスが表示されます。このダイアログボックスは,ユーザー名とパスワードの入力を要求し,ユーザーが入力した値を使って Params プロパティの UserName および PASSWORD 値を設定します。この値はリモートサーバーに渡されます。
OnLogin イベントハンドラを提供するアプリケーションは LoginParams に UserName および PASSWORD 値を設定する必要があります。LoginParams は一時的な文字列リストで,必要がなくなったら,自動的に解放されます。
メモ: ログインダイアログおよび OnLogin イベントが生成されるのは,LoginPrompt プロパティが true の場合だけです。