TsgcWebSocketServerEvents › OnMessage

OnMessage Gebeurtenis

Wordt geactiveerd elke keer dat een client een tekstbericht verzendt en dit door de server wordt ontvangen.

Syntaxis

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

Standaardwaarde

Opmerkingen

OnMessage wordt gegenereerd zodra een volledig tekstframe is ontvangen van een client. De parameter Text bevat de gedecodeerde UTF-8-tekenreeks en de parameter Connection identificeert de afzendersessie, zodat de handler kan antwoorden op dezelfde verbinding of het bericht kan doorsturen naar andere clients. Standaard is NotifyEvents neAsynchronous en de handler wordt gesynchroniseerd met de hoofdthread, wat het veilig maakt om UI-besturingselementen bij te werken; voor servers met hoge doorvoer stelt u NotifyEvents in op neNoSync om te verwerken in de verbindingsthread en implementeert u uw eigen synchronisatie. Als Options.FragmentedMessages frgOnlyFragmented is, wordt de gebeurtenis niet gegenereerd en wordt de payload geleverd via OnFragmented.

Voorbeeld


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

Terug naar gebeurtenissen