Datasnap.Win.MConnect.TCOMConnection.SetConnected
| [–] Properties | |
|---|---|
| Type: procedure function
| |
| Visibility: protected | |
| Source: Datasnap.Win.MConnect.pas Datasnap.Win.MConnect.hpp
| |
| Unit: Datasnap.Win.MConnect | |
| Parent: TCOMConnection | |
Delphi
procedure SetConnected(Value: Boolean); override;
C++
virtual void __fastcall SetConnected(bool Value);
Description
Sets the Connected property.
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.