Data.Win.ADODB.TADOConnection.Connected

De RAD Studio API Documentation

Delphi

property Connected: Boolean read GetConnected write SetConnected default 0;

C++

__property Connected = {default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property published
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TADOConnection

Description

Indique si une connexion a été établie avec la source de données distante et si elle est active.

Data.Win.ADODB.TADOConnection.Connected hérite de Data.DB.TCustomConnection.Connected. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TCustomConnection.Connected.

Indique si une connexion a été établie avec la source de données distante et si elle est active.

Mettez Connected à True pour ouvrir la connexion. Mettez Connected à False pour terminer la connexion.

L'affectation de True à la propriété Connected génère un événement BeforeConnect, appelle la méthode protégée DoConnect pour établir la connexion et génère un événement AfterConnect. De plus, quand Connected est initialisée à True, TCustomConnection peut afficher une boîte de dialogue de connexion suivant la valeur affectée à LoginPrompt.

L'affectation de False à la propriété Connected génère un événement BeforeDisconnect, appelle la méthode protégée DoConnect pour fermer la connexion et génère un événement AfterDisconnect.

Pour dériver des composants connexion personnalisés de TCustomConnection, redéfinissez GetConnected pour renvoyer True quand une connexion est établie et redéfinissez les méthodes DoConnect et DoDisconnect pour créer et fermer la connexion.

Conseil : Pour Bde.DBTables.TDatabase, initialisez Connected à True pour établir une connexion de base de données sans ouvrir d'ensemble de données. Une application peut tester la valeur de Connected pour déterminer l'état en cours d'une connexion de base de données. Si Connected vaut True, la connexion de base de données est active ; si elle vaut False et que la propriété KeepConnection vaut également False, la connexion est inactive. Affectez la valeur True à la propriété KeepConnection pour éviter d'avoir à se reconnecter au serveur à chaque fois qu'une connexion de base de données est de nouveau ouverte.

Voir aussi

Traductions