TsgcWebSocketClientEvents › OnMessage

OnMessage Gebeurtenis

Wordt geactiveerd elke keer dat de server een tekstbericht naar de client stuurt.

Syntaxis

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

Standaardwaarde

Opmerkingen

OnMessage wordt geactiveerd zodra een volledig tekstframe van de server is ontvangen. De parameter Text bevat de gedecodeerde UTF-8-tekenreeks; de parameter Connection identificeert de sessie waarop het bericht is aangekomen. Standaard is NotifyEvents neAsynchronous, zodat de handler wordt uitgevoerd in de context van de hoofdthread en het veilig is om UI-besturingselementen rechtstreeks bij te werken; schakel over naar neNoSync als de client een groot volume berichten ontvangt en u synchronisatie liever zelf afhandelt. Als Options.FragmentedMessages frgOnlyFragmented is, wordt deze gebeurtenis niet geactiveerd en wordt de payload afgeleverd via OnFragmented.

Voorbeeld


procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Server: ' + Text);
end;

Terug naar gebeurtenissen