TsgcWebSocketHTTPServerGebeurtenissen › 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 WebSocket-client. De parameter Text bevat de gedecodeerde UTF-8-string en de parameter Connection identificeert de afzendersessie, zodat de handler kan antwoorden op dezelfde verbinding of het bericht kan doorzenden naar andere clients. Standaard is NotifyEvents neAsynchronous en de handler wordt gesynchroniseerd met de hoofdthread, waardoor het veilig is om UI-besturingselementen bij te werken; stel voor servers met hoge doorvoer NotifyEvents in op neNoSync om te verzenden in de verbindingsthread en implementeer 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