Data.DB.TDataSet.Active

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Active: Boolean read GetActive write SetActive default False;

C++

__property bool Active = {read=GetActive, write=SetActive, default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet

Description

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 :

  1. Génère un événement BeforeOpen.
  2. Définit l'état de l'ensemble de données à dsBrowse.
  3. Etablit une méthode de récupération des données (en général, l'ouverture d'un curseur).
  4. 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 :

  1. Déclenche un événement BeforeClose.
  2. Définit la propriété State à dsInactive.
  3. Ferme le curseur.
  4. 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.

Remarque :  L'appel de la méthode Open initialise Active à true ; l'appel de la méthode Close initialise Active à false.

Voir aussi