Top Previous Next

Occurs when an application connects to a database.


   TPSQLDatabaseLoginEvent = procedure(Database: TPSQLDatabase;
                                    LoginParams: TStrings)of object;
property OnLogin: TPSQLDatabaseLoginEvent;


Write an OnLogin event handler to take specific actions when an application attempts to connect to a database.

By default, a database login is required. The current USERNAME is read from the Params property, and a standard login dialog box opens. The dialog prompts for a user name and password combination, and then uses the values entered by the user to set the UID and PWD values in the Params property. These values are then passed to the remote server.

Applications that provide alternative OnLogin event handlers must set the USERNAME and PASSWORD values in LoginParams. LoginParams is a temporary string list and is freed automatically when no longer needed.