Data.SqlExpr.TSQLConnection.LoadParamsFromIniFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure LoadParamsFromIniFile( FFileName: string = '');

C++

void __fastcall LoadParamsFromIniFile(System::UnicodeString FFileName = System::UnicodeString());

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TSQLConnection

Beschreibung

Weist den Eigenschaften DriverName und Params die Werte zu, die mit der Eigenschaft ConnectionName verknüpft sind.

Mit LoadParamsFromIniFile können Sie sicherstellen, dass die Eigenschaften DriverName und Params die Verbindungskonfiguration enthalten, die in der Datei AFileName hinterlegt ist. Wenn der Parameter AFileName weggelassen wird, verwendet LoadParamsFromIniFile die Datei dbxconnections.ini. Andernfalls wirdder vollständige Pfadname einer Datei übergeben, die dasselbe Format wie dbxconnections.ini hat. Sie können eine solche Datei anlegen, indem Sie die Datei dbxconnections.ini kopieren und der Kopie einen anderen Namen geben.

In den meisten Fällen ist es nicht erforderlich, eine Verbindungskonfiguration zur Laufzeit zu laden, da die Eigenschaften DriverName und Params automatisch belegt werden, wenn Sie der Eigenschaft ConnectionName während des Entwurfs einen Wert zuweisen. LoadParamsFromIniFile bietet jedoch die Möglichkeit, zur Laufzeit eigene, von den Einträgen in dbxconnections.ini verschiedene Verbindungskonfigurationen zu verwenden. Außerdem können Sie während des Entwurfs die Eigenschaften DriverName und Params zeitweilig außer Kraft setzen und zur Laufzeit wieder die Standardkonfiguration laden.

Anmerkung:  Setzen Sie die Eigenschaft LoadParamsOnConnect nicht auf true, wenn die Anwendung LoadParamsFromIniFile mit einer anderen Konfigurationsdatei aufruft. Wenn LoadParamsOnConnect true ist, wird die Konfiguration unmittelbar vor dem Öffnen der Verbindung aus der Datei dbxconnections.ini gelesen. Dadurch verlieren alle von LoadParamsFromIniFile geladenen Werte ihre Gültigkeit.

Siehe auch