TSQLConnection.LoadParamsFromIniFile Method

Sets the DriverName and Params properties to the values associated with the ConnectionName property.

Pascal

procedure LoadParamsFromIniFile(FFileName: UnicodeString = '');

C++

__fastcall LoadParamsFromIniFile(UnicodeString FFileName = '');

Description

Call LoadParamsFromIniFile to ensure that the DriverName and Params properties accurately reflect the connection configuration for the ConnectionName property that is stored in the file specified by the AFileName parameter. If the AFileName parameter is omitted, LoadParamsFromIniFile uses the dbxconnections.ini file. Otherwise, itis a fully-qualified path name to a file that has the same format as the dbxconnections.ini file. Typically, this file is created by making a copy of the dbxconnections.ini file under a different name.

In most cases, it is unnecessary to load connection configurations at runtime because when you set ConnectionName at design time, the DriverName and Params properties are automatically set as well. However, LoadParamsFromIniFile lets you use a customized set of connection configurations at runtime that differ from those stored in the dbxconnections.ini file, or to temporarily override the DriverName or connection parameter values at design time and then reestablish the defaults at runtime.

Note: Do not set the LoadParamsOnConnect property to true if your application calls LoadParamsFromIniFile and specifies an alternate connections file. When LoadParamsOnConnect is true, it loads the connection configuration from the dbxconnections.ini

file immediately before opening a connection, overriding any values loaded by this method.