RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCOMConnection.SetConnected Method

Sets the Connected property.

Pascal
procedure SetConnected(Value: Boolean); override;
C++
virtual __fastcall SetConnected(Boolean Value);

SetConnected is the protected implementation of the Connected property. 

If Value is false, SetConnected generates a BeforeDisconnect event, closes the connection, and generates an AfterDisconnect event. 

If Value is true, SetConnected performs the following actions: 

 

  1. It checks the value of the ServerGUID or ServerName property and raises an exception if these do not specify a valid application server. 

  2. If LoginPrompt is true, and the connection is not already open, SetConnected generates an OnGetUsername event, and uses that to initialize a login dialog. It displays the login dialog, and aborts the connection if the user cancels. 

  3. It generates a BeforeConnect event. 

  4. It opens the connection. 

  5. It generates an AfterConnect event. 

  6. If LoginPrompt is true, and the connection opened successfully, SetConnected generates an OnLogin event.

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!