FireDAC.Comp.Client.TFDCustomConnection.ConnectionName

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property ConnectionName: String read FConnectionName write SetConnectionName;

C++

__property System::UnicodeString ConnectionName = {read=FConnectionName, write=SetConnectionName};

Propriétés

Type Visibilité  Source Unité  Parent
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection

Description

Spécifie le nom de la connexion à associer à cet objet connexion.

Utilisez ConnectionName pour spécifier le nom de la connexion à utiliser avec un objet connexion. Si ConnectionName est identique à une définition de connexion existante, il n'est alors pas nécessaire de définir les propriétés ConnectionDefName et DriverName. Si ConnectionName ne correspond pas à une définition de connexion existante, l'application doit aussi fournir une définition de connexion valide dans la propriété ConnectionDefName ou fournir les propriétés DriverName et Params.

Vous pouvez spécifier le nom de connexion de l'un des objets TFDConnection existants ou le nom de l'une des définitions de connexion existantes en tant que nom de connexion pour le composant TFDCustomCommand ou TFDRDBMSDataSet et ses descendants (TFDQuery, TFDStoredProc, TFDTable).

Remarques :

  • Toute tentative de définition de ConnectionName quand la propriété Connected est définie sur True déclenche une exception.
  • A la conception, double-cliquez sur un composant TConnection pour invoquer l'éditeur de base de données et définir ConnectionName.

Exemple

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

Voir aussi