FireDAC.Comp.Client.TFDCustomManager.AddConnectionDef

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure AddConnectionDef(const AName, ADriver: string; AList: TStrings = nil;  APersistent: Boolean = False);

C++

void __fastcall AddConnectionDef(const System::UnicodeString AName, const System::UnicodeString ADriver, System::Classes::TStrings* AList = (System::Classes::TStrings*)(0x0), bool APersistent = false);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomManager


Beschreibung

Fügt die private Verbindungsdefinition hinzu.

Die Methode AddConnectionDef fügt der Liste ConnectionDefs eine neue private oder persistente Verbindungsdefinition hinzu.

Die Verbindungsdefinition erhält den Namen AName, die Treiber-ID ADriver und die Parameter AList. Der Name der Verbindungsdefinition muss eindeutig sein, d. h. er darf in der Liste ConnectionDefs nur einmal vorkommen, ansonsten wird eine Exception ausgelöst.

Setzen Sie APersistent auf True, um die Verbindungsdefinition als persistent zu kennzeichnen, ansonsten ist sie "private". Die persistente Verbindungsdefinition wird nach einem Aufruf nicht in einer Datei gespeichert. Rufen Sie SaveConnectionDefFile auf, um diese und andere Änderungen in einer Datei zu speichern. Nicht gespeicherte Verbindungsdefinitionen werden nach Beenden des FireDAC-Managers oder der Anwendung verworfen.

Nach dem Hinzufügen einer Verbindungsdefinition kann sie mit TFDCustomConnection.ConnectionDefName referenziert werden.

Beispiel

 
 var
   oList: TStringList;
 ......
   oList := TStringList.Create;
   oList.Add('Server=127.0.0.1');
   oList.Add('Database=addemo');
   FDManager.AddConnectionDef('myconn', 'MySQL', oList);
 ......
   FDConnection1.ConnectionDefName := 'myconn';
   FDConnection1.Connected := True;

Siehe auch

Beispiele