API:FireDAC.Comp.Client.TFDConnection.ConnectionName

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property ConnectionName: string read FConnectionName write SetConnectionName default 0;

C++

__property ConnectionName = {default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDConnection

Beschreibung

Gibt den Namen der Verbindung an, die diesem Verbindungsobjekt zugeordnet ist.

FireDAC.Comp.Client.TFDConnection.ConnectionName erbt von FireDAC.Comp.Client.TFDCustomConnection.ConnectionName. Der folgende Inhalt bezieht sich auf FireDAC.Comp.Client.TFDCustomConnection.ConnectionName.

Gibt den Namen der Verbindung an, die diesem Verbindungsobjekt zugeordnet ist.

Mit ConnectionName geben Sie den Namen der Verbindung an, die mit diesem Verbindungsobjekt verwendet werden soll. Wenn ConnectionName einer vorhandenen Verbindungsdefinition entspricht, dann müssen die Eigenschaften ConnectionDefName und DriverName nicht festgelegt werden. Wenn ConnectionName keiner vorhandenen Verbindungsdefinition entspricht, dann muss in der Anwendung auch eine gültige Verbindungsdefinition in der Eigenschaft ConnectionDefName angegeben sein oder die Eigenschaften DriverName und Params müssen entsprechende Werte enthalten.

Sie können den Verbindungsnamen eines vorhandenen TFDConnection-Objekts oder den Namen einer vorhandenen Verbindungdefinition als Verbindungsnamen für die Komponente TFDCustomCommand oder TFDRDBMSDataSet und deren Nachkommen (TFDQuery, TFDStoredProc, TFDTable) angeben.

Hinweise:

  • Der Versuch, ConnectionName zu setzen, wenn die Eigenschaft Connected True ist, löst eine Exception aus.
  • Doppelklicken Sie beim Entwurf auf eine TConnection-Komponente, um den Datenbank-Editor aufzurufen und den ConnectionName festzulegen.

Beispiel

 
 FDConnection1.ConnectionName := 'TestConn';
 FDConnection1.DriverName := 'Oracle';
 FDConnection1.Params.Add('Database=testdb');
 ....
 FDQuery1.ConnectionName := 'TestConn';
 FDQuery1.Open('select * from test_tab');

Siehe auch