Data.Win.ADODB.TADOConnection.OnConnectComplete

From RAD Studio API Documentation
Jump to: navigation, search

[–] Properties
Type: event
Visibility: published
Source:
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Unit: Data.Win.ADODB
Parent: TADOConnection

Delphi

property OnConnectComplete: TConnectErrorEvent read FOnConnectComplete write FOnConnectComplete;

C++

__property TConnectErrorEvent OnConnectComplete = {read=FOnConnectComplete, write=FOnConnectComplete};

Description

Occurs after starting a connection.

Write an OnConnectComplete event handler to take specific action after an attempt to connect to a database has successfully completed and the connection has started. The OnConnectComplete event fires after the corresponding operation (establishing a connection) has executed at the ADO Connection object. Calling the Open method or setting the Connected property to true will lead to this event occurring.

Error is an ADO Error object. See the Microsoft Data Access SDK for more information on using ADO Error objects. The Error parameter is only set if an error occurred during execution of the operation that triggered the event. In this case, the EventStatus parameter will contain the indicating value esErrorsOccured.

The EventStatus value (ADO EventStatusEnum) indicates the success or failure of the execution of the operation that triggered the event.

See Also