FireDAC.Comp.Client.TFDCustomManager.AddConnectionDef

From RAD Studio API Documentation
Jump to: navigation, search

[–] Properties
Type:
procedure
function
Visibility: public
Source:
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
Unit: FireDAC.Comp.Client
Parent: TFDCustomManager

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);

Description

Adds the private connection definition.

The AddConnectionDef method adds a new private or persistent connection definition to the ConnectionDefs list. 

The connection definition gets the name AName, the DriverID ADriver, and the parameters AList. The name must be unique across other connection definitions in the ConnectionDefs list, otherwise an exception is raised. 

Set APersistent to True, to mark the connection definition as persistent, otherwise this will be private. After a call, the persistent connection definition is not stored into a file. Call SaveConnectionDefFile to save this and other changes into a file. The connection definitions that are not stored will be discarded after the FireDAC manager or the application are terminated. 

After a connection definition is added, it can be referenced by TFDCustomConnection.ConnectionDefName.

Example

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;

See Also

Samples

Retrieved from "https://docwiki.embarcadero.com/Libraries/Florence/e/index.php?title=FireDAC.Comp.Client.TFDCustomManager.AddConnectionDef&oldid=736974"