FireDAC.Comp.Client.TFDQuery.Active

Aller au parent : TFDQuery

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	TFDQuery

Description

Indique si un ensemble de données est ouvert.

FireDAC.Comp.Client.TFDQuery.Active hérite de Data.DB.TDataSet.Active. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TDataSet.Active.

Indique si un ensemble de données est ouvert.

Utilisez la propriété Active pour déterminer si un ensemble de données est rempli de données. Si Active a la valeur false, l'ensemble de données est fermé ; il ne peut pas lire ou écrire des données et les contrôles orientés données ne peuvent pas l'utiliser pour récupérer des données ou transmettre des modifications. Si Active a la valeur true, des données peuvent remplir l'ensemble de données. L'ensemble de données peut lire des données dans une base de données ou une autre source, telle qu'un fournisseur. Selon la valeur de la propriété CanModify, les ensembles de données actifs peuvent transmettre les modifications.

L'initialisation de Active à true :

Génère un événement BeforeOpen.
Définit l'état de l'ensemble de données à dsBrowse.
Etablit une méthode de récupération des données (en général, l'ouverture d'un curseur).
Génère un événement AfterOpen.

Si une erreur se produit pendant l'ouverture de l'ensemble de données, il est placé dans l'état dsInactive et tout curseur est fermé.

L'initialisation de Active à false :

Déclenche un événement BeforeClose.
Définit la propriété State à dsInactive.
Ferme le curseur.
Déclenche un événement AfterClose.

Une application doit définir Active à false avant de modifier d'autres propriétés affectant l'état d'une base de données ou les contrôles affichant des données dans une application.