FireDAC.Comp.Client.TFDCustomManager.AddConnectionDef
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);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomManager |
説明
非公開接続定義を追加します。
AddConnectionDef メソッドでは、非公開または永続の接続定義を新しく ConnectionDefs リストに追加します。
接続定義の名前は AName、DriverID は ADriver、パラメータは AList になります。この名前は ConnectionDefs リストに含まれる接続定義の中で一意でなければなりません。そうでなければ例外が発生します。
APersistent を True に設定すると、接続定義が永続になります。そうでなければ非公開になります。呼び出した後、永続接続定義はファイルに格納されていません。SaveConnectionDefFile を呼び出すと、永続接続定義やその他の変更をファイルに保存することができます。保存されなかった接続定義は、FireDAC マネージャまたはアプリケーションが終了した後で破棄されます。
追加した接続定義は、TFDCustomConnection.ConnectionDefName で参照することができます。
例
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;