FireDAC.Comp.Client.TFDCustomConnection.ConnectionName
Delphi
property ConnectionName: String read FConnectionName write SetConnectionName;
C++
__property System::UnicodeString ConnectionName = {read=FConnectionName, write=SetConnectionName};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomConnection |
説明
この接続オブジェクトに関連付ける接続の名前を指定します。
ConnectionName を使用すると、接続オブジェクトで使用する接続の名前を指定できます。ConnectionName が既存の接続定義と同じ場合は、ConnectionDefName プロパティと DriverName プロパティを設定する必要はありません。ConnectionName が既存の接続定義と一致しない場合、アプリケーションでは、有効な接続定義を ConnectionDefName プロパティにも指定する必要があるか、あるいは DriverName プロパティと Params プロパティを指定する必要があります。
既存の TFDConnection オブジェクトの 1 つの接続名または既存の接続定義の 1 つの名前を、TFDCustomCommand または TFDRDBMSDataSet コンポーネントおよびその下位コンポーネント（TFDQuery、TFDStoredProc、TFDTable）の接続名として指定できます。
メモ：
- Connected プロパティが True の場合に ConnectionName を設定しようとすると、例外が発生します。
- 設計時には、TConnection コンポーネントをダブルクリックして［FireDAC 接続エディタ］を起動し、ConnectionName を設定します。
例
FDConnection1.ConnectionName := 'TestConn';
FDConnection1.DriverName := 'Oracle';
FDConnection1.Params.Add('Database=testdb');
....
FDQuery1.ConnectionName := 'TestConn';
FDQuery1.Open('select * from test_tab');