FireDAC.Comp.Client.TFDManager.Active

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Active: Boolean read GetActive write SetActive default 0;

C++

__property Active = {default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDManager

Description

Obtient ou définit l'état actif du gestionnaire FireDAC.

FireDAC.Comp.Client.TFDManager.Active hérite de FireDAC.Comp.Client.TFDCustomManager.Active. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDCustomManager.Active.

Obtient ou définit l'état actif du gestionnaire FireDAC.

Définissez Active sur True pour activer le gestionnaire FireDAC. En conséquence, State est défini sur dmsActive. Lors de l'activation du gestionnaire FireDAC, FDPhysManager charge le fichier de définition de pilote. Si besoin, définissez DriverDefFileAutoLoad et DriverDefFileName avant d'activer le gestionnaire. TFDCustomConnection active automatiquement le gestionnaire avant une première connexion.

Définissez Active sur False pour terminer le gestionnaire FireDAC. En conséquence, State prend la valeur dmsInactive. A la fin de l'opération, le gestionnaire exécute les actions suivantes :

  • Appelle TFDCustomConnection.Close pour tous les objets de connexion de l'application.
  • FDPhysManager attend que toutes les interfaces de connexions (IFDPhysConnection) soient libérées.
  • Décharge les DLL du client DBMS et libère les structures de pilote interne.

Remarque : Pour modifier des paramètres du pilote, le gestionnaire peut être actif ou inactif, mais il ne doit exister aucune connexion via ce pilote.

Nous vous recommandons vivement de ne pas fermer le gestionnaire FireDAC à partir des événements OnLost, OnRestored et OnRecover du composant TFDConnection, car cela peut générer des problèmes imprévus.

Une application multi-thread doit activer le gestionnaire FireDAC avant le démarrage des threads se connectant à une base de données.

Voir aussi