TsgcWebSocketServer_HTTPAPI › Events › OnMessage
Wordt geactiveerd elke keer dat een client een tekstbericht verzendt en dit door de server wordt ontvangen.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object
—
OnMessage wordt geactiveerd zodra een volledig tekstframe van een client is ontvangen via de HTTP.SYS WebSocket-pipeline. De parameter Text bevat de gedecodeerde UTF-8-string en de parameter Connection identificeert de verzendende sessie, zodat de handler op dezelfde verbinding kan antwoorden of het bericht naar andere clients kan doorsturen. De gebeurtenis draait in de context van de IOCP-workerthread; als u UI-controls moet bijwerken, marshall de aanroep naar de hoofdthread. Als Options.FragmentedMessages frgOnlyFragmented is, wordt de gebeurtenis niet geactiveerd en wordt de payload in plaats daarvan via OnFragmented geleverd.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;