Datasnap.Win.MConnect.TCOMConnection.SetConnected

Übergeordnet: TCOMConnection

Delphi

procedure SetConnected(Value: Boolean); override;

C++

virtual void __fastcall SetConnected(bool Value);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	protected	Datasnap.Win.MConnect.pas Datasnap.Win.MConnect.hpp	Datasnap.Win.MConnect	TCOMConnection

Beschreibung

Weist der Eigenschaft Connected einen Wert zu.

Die Methode SetConnected ist die als protected deklarierte Implementierung der Eigenschaft Connected.

Wenn Value false ist, erzeugt SetConnected ein BeforeDisconnect-Ereignis, schließt die Verbindung und generiert ein AfterDisconnect-Ereignis.

Wenn Value true ist, führt SetConnected folgende Aktionen aus:

1. Der Wert der Eigenschaft ServerGUID bzw. ServerName wird überprüft und eine Exception ausgelöst, wenn die Eigenschaft nicht auf einen gültigen Anwendungs-Server zeigt.

2. Wenn LoginPrompt true und die Verbindung noch nicht geöffnet ist, erzeugt SetConnected ein OnGetUsername-Ereignis und initialisiert das Anmeldedialogfeld. Anschließend wird dieses Dialogfeld angezeigt. Wenn der Benutzer das Dialogfeld mit Abbrechen schließt, wird die Verbindung beendet.

3. Ein BeforeConnect-Ereignis wird generiert.

4. Die Verbindung wird geöffnet.

5. Ein AfterConnect-Ereignis wird generiert.

6. Wenn LoginPrompt den Wert true hat und die Verbindung geöffnet werden konnte, generiert SetConnected ein OnLogin-Ereignis.