Data.DB.TCustomConnection.OnLogin
Delphi
property OnLogin: TLoginEvent read FOnLogin write FOnLogin;
C++
__property Data::Dbcommontypes::TLoginEvent OnLogin = {read=FOnLogin, write=FOnLogin};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
event | public | Data.DB.pas Data.DB.hpp |
Data.DB | TCustomConnection |
説明
サーバーに対して通信チャネルを開いたときに発生します。
OnLogin は、LoginPrompt プロパティが true の場合に、接続を開いたときに発生します。
DataSnap 接続コンポーネントの場合、アプリケーション サーバーへの接続を開くと、以下の一連のイベントが発生します。
- OnGetUsername イベントが発生します。このイベントで、アプリケーションはログイン ダイアログに初期ユーザー名を設定できます。
- ログイン ダイアログが表示されます。このダイアログで、ユーザーはユーザー名とパスワードを指定できます。
- BeforeConnect イベントが発生し、接続が開き、AfterConnect イベントが発生します。
- OnLogin イベントが発生します。このイベントには、リモート ログイン ダイアログで指定するユーザー名とパスワードを使用してアプリケーション サーバーにログインするためのコードを記述できます。
メモ: 接続コンポーネントが別の方法でログインを行う場合は、OnLogin イベントを使用しないでください。たとえば、TWebConnection は Username プロパティおよび Password プロパティを代わりに使用します。
ADO 接続コンポーネントの場合、アプリケーション サーバーへの接続を開くと、以下の一連のイベントが発生します。
- BeforeConnect イベントが発生します。
- OnWillConnect イベントが発生します。このイベントで、アプリケーションは、接続オプションや状態の設定、およびログイン ダイアログでの初期ユーザー名とパスワードの設定を行うことができます。
- ログイン ダイアログが表示されます。このダイアログで、ユーザーはユーザー名とパスワードを指定できます。
- OnLogin イベントが発生します。このイベントには、ユーザーが指定した値に応答するコードを記述できます。(たとえば、アプリケーション固有のユーザー名とパスワードをデータベース用のユーザー名とパスワードに変換できます)。
- 接続が開き、AfterConnect イベントが発生します。
メモ: 多層データベース アプリケーションの、アプリケーション サーバーに接続しない接続コンポーネントには、TCustomConnection に定義された OnLogin イベントを、接続が確立する前に発生する別のイベントに置き換えるものもあります。