FireDAC.Comp.Client.TFDCustomManager.AddConnectionDef

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomManager


Description

Ajoute la définition de connexion privée.

La méthode AddConnectionDef ajoute une nouvelle définition de connexion privée ou persistante à la liste ConnectionDefs

La définition de connexion obtient le nom AName, l'identificateur de pilote ADriver et les paramètres AList. Le nom doit être unique pour les autres définitions de connexion de la liste ConnectionDefs, sinon une exception est déclenchée. 

Définissez APersistent sur True pour marquer la définition de connexion comme persistante ; sinon, elle sera privée. Après un appel, la définition de connexion persistante n'est pas stockée dans un fichier. Appelez la méthode SaveConnectionDefFile pour effectuer l'enregistrement de l'opération et d'autres modifications dans un fichier. Les définitions de connexion qui ne sont pas stockées sont abandonnées une fois que le gestionnaire FireDAC ou l'application prend fin. 

Une fois qu'une définition de connexion est ajoutée, elle peut être référencée par TFDCustomConnection.ConnectionDefName.

Exemple

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;

Voir aussi

Exemples