TCustomConnection.Connected Property

Determines whether a connection has been established to the remote source of data.

Pascal

property Connected: Boolean;

C++

__property Boolean Connected;

Description

Set Connected to true to open the connection. Set Connected to false to terminate the connection.

Setting Connected to true generates a BeforeConnect event, calls the protected DoConnect method to establish the connection, and generates an AfterConnect event. In addition, when setting Connected to true, TCustomConnection may display a login dialog, depending on the value of LoginPrompt.

Setting Connected to false generates a BeforeDisconnect event, calls the protected DoConnect method to drop the connection, and generates an AfterDisconnect event.

When deriving custom connection components from TCustomConnection, override GetConnected to return true when a connection is established, and override DoConnect and DoDisconnect to create and drop the connection.